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Preface 


This publication is a reference manual 
for the programmer using the assembler 
language (including macro definitions and 
conditional assembly facilities). This 
publication also contains information 
peculiar to DOS and TOS for the D and F 
assembler. 

Part 1 of this publication presents 
information common to all parts of the 
language. Part 2 contains specific 
information concerning the symbolic machine 
instruction codes and the assembler program 
functions provided for the programmer's 
use. Part 3 of this publication describes 
the conditional assembler and macro 
facilities in the assembler language. 

Appendixes A through P follow Part 3. 
Appendixes A through F are associated with 
Parts 1 and 2 and present such items as a 
summary chart for constants, instruction 
listings, character set representations, 
and other aids to programming. Appendix G 
contains macro facility summary charts, and 
Appendix H discusses table capacities for 
various elements of the language. Appendix 
I is a sample program and assembler listing 
•description. Appendix J is a features 
comparison chart of the OS assenblers. 
Appendix K gives examples of the cards 
needed for assembler runs. Appendix L 
contains a description of how another 
version of the assembler can be included in 
the core image library. Appendix M 
describes the output produced by the 
assembler. Appendix N explains the 
diagnostic error messages that can be 
issued by the assembler. Appendix 0 
contains self-relocating program 
techniques. Appendix P contains sample 
macro definitions. 


Prerequisite for a thorough 
understanding of this publication is a 
basic knowledge of OS machine concepts. 
The publications most closely related to 
this are: 


1. IBM System/360 Principles of 

Operation , Order No. GA22-6821. 


2. DOS Data Management Concepts , Order 
No. GC24-3427, or 

IBM System/360 Tape Operating System : 
Data Management Concepts , Order No. 
GC24-3430. 

3. DOS Supervisor and I/O Macros , Order 
No. GC24-5037, or 

IBM System/360 Tape Operating System : 
Supervisor and Input/Output Macros , 
Order No. GC24-5035. 

. DOS System Control and Service , Order 
No. GC24-5036, or 

IBM System/360 Tape Operating System : 
System Control and System Service 
Programs , Order No. GC24-5034. 

5. DOS System Generation , Order No. 
GC24-5033, or 

IBM System/360 Tape Operating System : 
System Generation and Maintenance , 
Order No. GC24-5015. 

6. DOS and TOS Utility Macros , Order No. 
GC24-5042. 

Titles and abstracts of other related 
publications are listed in the IBM 
System/360 Bibliography , Order 
No. GA22-6822. 
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Part 1-Introduction to the Assembler Language 




Section 1. Introduction 


Computer programs may be expressed in 
machine language, i.e., language directly 
interpreted by the computer, or in a 
symbolic language, which is much more 
meaningful to the programmer. The symbolic 
language, however, must be translated into 
machine language before the computer can 
execute the program. This function is 
accomplished by an associated processing 
program called an assembler or a compiler. 


Of the various symbolic programming 
languages, assembler languages are closest 
to machine language in form and content. 


The assembler language discussed in this 
manual is a symbolic programming language 
for the IBM System/360. It enables the 
programmer to use all IBM Systen/360 
machine functions, as if he were coding in 
IBM System/360 machine language. 

A program written in the assembler 
language will normally consist of three 
types of instructions: machine 
instructions, assembler instructions, and 
macro instructions. They are all coded in 
a language that can be interpreted by the 
assembler processor program. Machine 
instructions are transformed into machine 
language instruction by instruction. This 
language can be directly interpreted by the 
machine. Their functions are not described 
in this manual. Refer to IBM System/360 
Principles of Operation . 

Assembler instructions are used by the 
assembler during processing to manipulate 
the source program written in the assembler 
language. They are described in this 
manual. 

IBM-supported macro instructions provide 
easy access to the control programs 
supplied by the system under which the 
installation is running. They are 
described in IBM System/360 Tape Operating 
System Supervisor and Input/Output Macros , 
and in DOS Supervisor and I/O Macros . The 
user can also write his own macro 
definitions to obtain easy access to 
precoded sections of code. Writing macro 
definitions is covered in this manual. 

Under the Disk and Tape Operating 
Systems a few different assembler variants 
are available. They are: 

TOS: Assembler D, 10K variant 

Assembler D, 14K variant 


DOS: Assembler D, 10K variant 
Assembler D, 14K variant 
Assembler F 

The requirements and features of the 
variants are described below. Two of the 
assemblers, the DOS Assembler D, 14K 
variant, and the Assembler F contain 
features not supported by the other DOS/TOS 
assemblers. 


Machine Features Required 


A minimum of 16,384, 24,576, or 65,536 
bytes of main storage as detailed below: 

® 16,384 (16K) bytes of main storage, of 

which at least 10,240 contiguous bytes 
must be available to the assembler. 
This is the core requirement for the 
10K variant DOS and TOS D assemblers. 

• 24,576 (24K) bytes of main storage, of 
which at least 14,336 contiguous bytes 
must be available to the assembler. 
This is the core requirement for the 
14K variant DOS and TOS D assemblers. 

• 65,536 (64K) bytes of main storage, of 
which at least 45,056 contiguous bytes 
must be available to the assembler. 
This is the core requirement for the 
44K DOS F assembler. 

Note : The minimum partition required when 

the assembler is executed in the foreground 
partitions is 2K larger than the minimum 
main storage requirements stated above. 
Additional storage, available to any of the 
assemblers, is used to expand assembler 
tables. For details on how to call a 
specific assembler see Appendix K and the 
DOS and TOS System Generation publications 
(listed in "Preface") . 

• Standard instruction set. 

• One I/O Channel (either multiplexor or 
selector) . 

• One Card Reader (1442N1, 2501, 2520E1, 
or 2540) 

• One Card Punch (1442N1, 1442N2,2520, 
or 2540) 1 , if punched, output is 
desired 

• One Printer (1403, 1404—continuous 
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forms only, or 1443) 1 , if a printed 
listing is desired. 

• One 1052 Printer-Keyboard. 

• One 2311, 2314, or 2319 Disk Storage 
Drive. This has the DOS resident 
system pack. 

or 

• One 2400-series Magnetic Tape Unit 
(either 7-track or 9-track). This has 
the TOS resident system. 

• Three work files. Under the DOS D 

Assembler, 10K Variant: either three 
disk storage extents or three magnetic 
tape units. The devices used must be 
all of the same type; i.e., three 
magnetic tape units, three 2311 disk 
storage extents, or three 2314 or 2319 
disk storage extents. Under the DOS D 
Assembler, 14K Variant, and the DOS F 
Assembler: any combination of disk 

storage extents and/or magnetic tape 
units. The disk storage devices used 
need not be of the same type as that 
of SYSRES. Under the TOS D Assembler, 
10K and 14K Variants: three magnetic 
tape units. The devices used must be 
of the same type as that of SYSRES. 

The allowable disk storage devices are 
the 2311, 2314, and the 2319 Disk Storage 
Drives. The allowable magnetic tape units 
are 2400-series Magnetic Tape Units (either 
7-track or 9-track: if 7-track, the data 
conversion feature is required and the tape 
must be set converter on, translator off, 
odd parity). 

Under the DOS D Assembler, 10K Variant, 
only the system source statement library is 
supported. Under the DOS D Assembler, 14K 
Variant, and the DOS F Assembler, a private 
source statement library is supported. 

Under the TOS D Assembler, 10K and 14K 
Variants, the standard private library is 
supported. The device used for the private 
library must be of the same type as that of 
SYSRES. 

For the 10K DOS and the 14K TOS D 
assemblers, the assemble-and-execute option 
is an alternative to the DECK option; both 
are not supported for the same assembly. 

For the 14K DOS D assembler and for the F 


A 2400-series Magnetic Tape Unit may be 
substituted for this device. (It may be 
7-track or 9-track. If 7-track is used 
the data conversion feature is required 
and the tape must be set converter on, 
translator off, odd parity.) The 1052 
Printer-Keyboard must be operable if 
device assignment is tape. 


assembler, both options are supported in 
the same assembly. If the 
assemble-and-execute option is chosen, 
SYSLNK is a 2400-series Magnetic Tape Unit 
(9-track or 7-track with the data 
conversion feature) for the tape resident 
system, or a 2311, 2314, or 2319 Disk 
Storage extent (which may be on the system 
resident device) for the disk resident 
system. 

If, for assembly, LINK or CATAL options 
are chosen, the I/O requirements for 
SYSLNK must be met. 

Compatibility between System/360 
Assemblers 

The assemblers described in this manual can 
be used under the Disk or Tape Operating 
System running on an IBM System/360 Model 
30 or larger or on an IBM System/370 
machine, provided that main storage and 
input/output requirements are satisfied. 

The following describes the 
compatibility between: 

• the different DOS/TOS assemblers 

• the DOS/TOS assemblers and the OS 
assemblers 

• the BPS/BOS assemblers and the DOS/TOS 
assemblers. 

Incompatibilities caused by some other part 
of a system than the assembler are not 
described. For example, if a program 
segmented into an overlay structure under 
OS is run under DOS in the same overlay 
structure, V-type address constants that 
reference external data can be invalid. 

The programmer must also realize that 
IBM-supplied macros differ from system to 
system. A DTFCD macro coded for DOS will 
be treated as an undefined operation code, 
if assembled under OS. 

Treatment of erroneous input, as well as 
the assignment, size, and ordering of 
literal pools can also differ among the 
assemblers. 


DOS/TOS Assembler Variants 


The TOS variants and the 10K variant of the 
DOS Assembler D accept the same input and 
produce identical output. A program 
accepted by these variants will also be 
accepted by the 14K variant of the DOS 
Assembler D and Assembler F. Those two 
variants have a few extended features. 
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The DOS Assembler D, 14K variant, 
contains the following features not 
supported by any of the other DOS/TOS 
assemblers: 


• The WXTRN instruction 

• All System/370 instructions. The 
additional instructions are: AXR, 
CLCTL, CLM, HDV, ICM, LCTL, LRDR, 

LRER, MC, MVCL, MXD, MXDR, MXR, SCK, 
SIOF, SRP, STCK, STCM, STCTL, STIDC, 
STIDP, and SXR. 

• The L-type constant 

• SSYSPARM 

The DOS Assembler F contains the 
following features not supported by the 
other DOS/TOS assemblers: 

• Two continuation lines allowed for 
source statements other than macro 
instructions and prototype statements. 
Assembler D only allows one per 
statement. 

• Multiple operands in a DC statement. 

• Bit length specification in DC 
statements. 

• The maximum number of operands in a 
macro instruction or prototype 
statement is 200 as opposed to 100 for 
Assembler D. 

• The maximum size of a character 
expression is 255 characters as 
opposed to 127 for Assembler D. 

• The maximum value of a subscript of 
SSYSLIST is 200 as opposed to 100 for 
Assembler D. 


The DOS/TOS Assemblers and the OS 
Assemblers 


The DOS Assembler F implements the full 
System/360 Operating System assembler 
language at the F level with the following 
exceptions: 

• CXD and DXD statements 

• Q-type address constants 

• The special instructions for 
System/370 and System/360 Models 85 
and 195. 

• The WXTRN instruction 


• The L-type constant 

Source code written for any DOS/TOS 
assembler except the DOS Assembler D, 14K 
variant, will be accepted by the OS 
Assembler F. The 14K variant supports 
SSYSPARM, which is not supported by OS. 


The BOS/BPS Assemblers and the DOS/TOS 
Assemblers 


The DOS/TOS assemblers accept source 
programs written in the IBM System/360 
Basic Programming Support Assembler (8K 
Tape) Language, the IBM 7090/7094 Support 
Package for IBM System/360 Assembler 
Language, and the IBM System/360 Basic 
Operating System (8K Disk) Assembler 
Language with the following restrictions: 

• The XFR instruction is not allowed in 
DOS/TOS. 

• If SET symbols are used in macros 
generated in the source code, LCLx and 
GBLx instructions must be added in 
those macro definitions to declare the 
SET symbols. 

• An MNOTE assembler instruction whose 
operand entry consists solely of a 
message enclosed in apostrophes, is 
given a severity code of one. 

• The logical expression in an AIF 
statement must not be explicit zeros 
or ones. 

Note 1 : The DOS/TOS assemblers accept AIFE 
and AGOB statements. They are treated as 
AIF and AGO statements. 

Note 2 : Assembler control statements 
(AWORK, AOPTN, etc.) should be excluded 
from the input to the DOS/TOS assembler. 
They are treated as undefined operation 
codes. 


The Assembler Language 

The basis of the assembler language is a 
collection of mnemonic symbols which 
represent: 

1. IBM System/360 Operating System 
machine language operation codes. 

2. Operations (auxiliary functions) to be 
performed by the assembler program. 

The language is augmented by other 
symbols, supplied by the programmer, and 
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these symbols are used to represent storage 
addresses or data. Symbols are easier to 
remember and code than their machine 
language equivalents. Use of symbols 
greatly reduces programming effort and 
error. 


MACHINE OPERATION CODES 


The assembler language provides mnemonic 
machine instruction operation codes for all 
machine instructions in the IBM System/360 
Universal Instruction Set, and extended 

^ J- XZ - 

jl\_ ujjcj.atiun ^uuco iui tac 

conditional branch instruction. 


ASSEMBLER OPERATION CODES 


The assembler language also contains 
mnemonic assembler instruction operation 
codes, used to specify auxiliary functions 
to be performed by the assembler program. 
These are instructions to the assembler 
program itself and, with a few exceptions, 
do not result in the generation of any 
machine language code by the assembler 
program. Certain assembler instructions, 
i.e. , conditional assembly instructions, 
affect the order of source statement 
assembly and macro generation or the 
content of generated instructions. 


MACRO INSTRUCTIONS 


The assembler language enables the 
programmer to define and use macro 
instructions. Macro instructions are 
represented by an operation code which, in 
turn, actually stands for a sequence of 
machine and/or assembler instructions that 
accomplish the desired function. 

Macro instructions used in preparing an 
assembler language source program fall into 
two categories: system macro instructions, 
provided by IBM, which relate the object 
program to components of the Basic 
Operating System, and macro instructions 
created by the programmer specifically for 
use in the program at hand, or for 
incorporation in a library, available for 
future use. 

Programmer-created macro instructions 
are used to simplify the writing of a 
program and/or to ensure that a standard 
sequence of instructions is used to 
accomplish a desired function. 


For instance, the logic of a program may 
require the same instruction sequence to be 
executed again and again. Rather than code 
this entire sequence each time it is 
needed, the programmer creates a macro 
instruction to represent the sequence, and 
then each time the sequence is needed, the 
programmer simply codes the macro 
instruction statement. During assembly, 
the sequence of instructions represented by 
the macro xnstructi.cn xs inserted in the 
object program. Part 3 of this publication 
discusses the conditional assembly and 
macro facilities. 


mi_x_'Ll_n_ ..... 

me nssemoiei rrogrdia 


The assembler program, also referred to as 
the "assembler", processes source 
statements written in the assembler 
language. The assembler is separated into 
an assembly section and a conditional 
assembly and macro generation section. 


THE MACRO GENERATION AND CONDITIONAL 
ASSEMBLY SECTION 


Before source statements can be translated 
into actual machine language, macro 
instructions and conditional assembly 
statements within the source program must 
be processed. The source program is read. 
Any programmer macro definitions which 
appear before the main portion of the 
program are stored for use when the macro 
is referenced. (System macro definitions 
are retrieved from the source statement 
library and handled in the same way.) 

The main portion of the program is then 
processed. Whenever macro generation or 
conditional assembly is required, the 
generated or conditionally assembled text 
is inserted in the original source program. 
The resultant augmented source program is 
ready for input to the assembly section. 


THE ASSEMBLY SECTION 


Processing a source program involves the 
translation of source statements into 
machine language, the assignment of storage 
locations to instructions and other 
elements of the program, and the 
performance of the auxiliary assembler 
program functions designated by the 
programmer. The output of the assembler 
program is the object program , a machine 
language equivalent of the source program. 
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The assembler program furnishes a printed 
listing of the source statements and object 
program statements and additional 
information useful to the programmer in 
analyzing his program, such as error 
indications. The object program is in the 
format required by the linkage editor 
component of DOS/TOS. 

The amount of main and secondary storage 
allocated to the assembler program for use 
during processing determines the maximum 
number of certain language elements that 
may be present in the source program. For 
a discussion of these dependencies, see 
Appendix H. 


Programmer Aids 

The assembler program provides auxiliary 
functions that assist the programmer in 
checking and documenting programs, in 
controlling address assignment, in 
segmenting a program, in data and symbol 
definition, in generating macro 
instructions, and in controlling the 
assembly program itself. Mnemonic codes, 
specifying these functions, are provided in 
the language. 

Variety in Data Representation . Decimal, 
binary, hexadecimal, or character 
representation of machine language binary 
values may be employed by the programmer in 
writing source statements. The programmer 
selects the representation best suited to 
his purpose. 

Base Register Address Calculation . As 
discussed in the IBM Svstem/360 Principles 
of Operation manual, the operating system 
addressing scheme requires the designation 
of a base register (containing a base 
address value) and a displacement value in 
specifying a storage location. The 
assembler assumes the clerical burden of 
calculating storage addresses in these 
terms for the symbolic addresses used by 
the programmer. The programmer retains 
control of base register usage and the 
values entered therein. 

Relocatability . The object programs 
produced by the assembler are in a format 
enabling relocation from the originally 
assigned storage area to any other suitable 
area. 


Sectioning and Linking . The assembler 
language and program provide facilities for 
partitioning an assembly into one or more 
parts called control sections . Control 
sections may be added or deleted when 
linkage editing the object program. 

Because control sections do not have to be 
loaded contiguously in storage, a sectioned 
program may be loaded and executed even 
though a continuous block of storage large 
enough to accommodate the entire program 
may not be available. 

The linking facilities of the assembler 
language and program allow symbols to be 
defined in one assembly and referred to in 
another, thus effecting a link between 
separately assembled programs. This 
permits reference to data and/or transfer 
of control between programs. A discussion 
of sectioning and linking is in Section 3 
under "Program Sectioning and Linking." 


Program Listings . A listing of the source 
program statements and the resulting object 
program statements may be produced by the 
assembler for each source program it 
assembles. The programmer can partly 
control the form and content of the 
listing. 

Error Indications . As a source program is 
assembled, it is analyzed for actual or 
potential errors in the use of the 
assembler language. Detected errors are 
indicated in the program listing. 


Assembler-DOS/TOS Relationships 

The assembler program is a component of IBM 
disk and tape operating systems and 
functions under their control. DOS/TOS 
provides the assembler with input/output 
library, and other services needed in 
assembling a source program. In a like 
manner, the object program produced by the 
assembler will normally operate under 
control of DOS/TOS and depend on it for 
input/output and other services. In 
writing the source program, the programmer 
must include statements requesting the 
desired functions from DOS/TOS. (See the 
Supervisor and Input/Output Macros 
publications listed in the "Preface".) 
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Section 2. General Information 


This section presents information about 
assembler language coding conventions, 
assembler source statement structure, 
addressing, and the sectioning and linking 
of programs. 


Assembler Language Coding Conventions 

This subsection discusses the general 
coding conventions associated with use of 
the assembler language. 


CODING FORM 


A source program is a sequence of source 
statements that are punched into cards. A 
standard assembler card is shown in Figure 
2. These statements may be written on the 
standard coding form, GX28-6509 (Figure 1) , 
provided by IBM. One line of coding on the 
form is punched into one card. The 
vertical columns on the form correspond to 
card columns. 

Space is provided on the form for 
program identification and instructions to 
keypunch operators. None of this 
information is punched into a card. 

The body of the form (Figure 1) is 
composed of two fields: the statement 
field, columns 1-71, and the 
identification-sequence field, columns 
73-80. The identification-sequence field 
is not part of a statement and is discussed 
following the subsection "Statement 
Format." 

The entries (i.e., coding) composing a 
statement occupy columns 1-71 of a 


statement line and, if needed, columns 
16-71 of successive continuation lines. 


CONTINUATION LINES 


When it is necessary to continue a 
statement on another line the following 
rules apply. 

1. Enter any nonblank character in the 
continuation column (end column plus 
one) of the statement line. 

2. Continue the statement on the next 
line, starting in the continue column. 
Columns to the left of the continue 
column must be blank. 

One continuation line is allowed for the 
D assembler and two continuation lines are 
allowed for the F assembler, except for 
source macro instructions and macro 
prototype statements, which may have more 
than one continuation line (see Part 3) . 


STATEMENT BOUNDARIES 


Source statements are normally contained in 
columns 1-71 of statement lines and columns 
16-71 of any continuation lines. 

Therefore, columns 1, 71, and 16 are 
referred to as the "begin", "end", and 
"continue" columns, respectively. This 
convention may be altered by use of the 
Input Format Control (ICTL) assembler 
instruction discussed later in this 
publication. 
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Figure 2. Punched Card Form 


STATEMENT FORMAT from left to right: a name entry, an 

_ operation entry, an operand entry, and a 

comments entry. These entries must be 

There are two types of separated by one or more blanks, and must 

statements—instructions and comments. be written in the order stated. Total 

statement size is limited to 187 

Instructions may consist of one to four characters. If this limit is exceeded, the 
entries in the statement field. They are. 
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assembly listing may be incorrect for that 
statement. 

The coding form {Figure 1) is ruled to 
provide an eight-^character name field, a 
five-character operation field, and a 
56-character operand and/or comments field. 

If desired, the programmer may disregard 
these boundaries and write the name, 
operation, operand, and comment entries in 
other positions, subject to the following 
rules: 

1. The entries must not extend beyond 
statement boundaries (either the 
conventional boundaries, or as 
designated by the programmer via the 
ICTL instruction) . 

2. The entries must be in proper 
sequence, as stated above. 


Operand Entries . Operand entries are the 
coding that identifies and describes data 
to be acted upon by the instruction, by 
indicating such things as storage 
locations, masks, storage area lengths, or 
types of data. 

Depending on the need of the 
instruction, one or more operands may be 
written. Operands are required for all 

machine instructions. 

Operands must be separated by commas. 
Blanks must not intervene between operands 
and the commas that separate them. 

The operands may not contain embedded 
blanks except as follows: If character 
representation is used to specify a 
constant, a literal, or immediate data in 
an operand, the character string may 
contain blanks, e.g., C'AB D*. 


3. The entries must be separated by one 
or more blanks. 

4. If used, a name entry must be written 
starting in the begin column. 

5. The name and operation entries must be 
completed in the first line of the 
statement, including at least one 
blank following the operation entry. 

A description of the name, operation, 
operand, and comments entries follows: 

Name Entries : The name entry is a symbol 
created by the programmer to identify a 
statement. It consists of one to eight 
alphanumeric characters, the first of which 
must be alphabetic. A name entry is 
usually optional, but, if present, must be 
entered with the first (or only) character 
appearing in the begin column. If the 
begin column is blank, the assembler 
program assumes no name has been entered. 
Blanks must not appear within a name entry, 
whether the symbol was introduced directly 
by the programmer or indirectly by 
conditional assembly or macro generation. 

Operation Entries . The operation entry is 
the mnemonic operation code specifying the 
desired machine operation, macro, or 
assembler function. An operation entry is 
mandatory and must appear in the first 
statement line, starting at least one 
position to the right of the begin column. 
Valid mnemonic operation codes for machine 
and assembler operations are contained in 
Appendixes D and E of this publication. 
Valid operation codes consist of five 
characters or fewer for machine or 
assembler operation codes, and eight 
characters or fewer for macro instruction 
operation codes. No blanks may appear 
within the operation entry. 


Comments Entries . Comments are descriptive 
items of information about the program that 
are to be inserted in the program listing. 
All 256 valid characters, including blanks, 
may be used in writing a comment. The 
entry cannot extend beyond the end column 
(normally column 71), and a blank must 
separate it from the operand. 

In instructions where an operand entry 
is optional but not present and a comments 
entry is desired, the absence of the 
operand entry must be indicated by a comma 
preceded and followed by one or more 
blanks, as follows: 


r- t- t - 

j Name |Operation|Operand 

* - + - +- 

I 


j START 


COMMENT 


END 


COMMENT 


Instruction Example . The following 
illustrates the use of name, operation, 
operand, and comments entries. A compare 
instruction has been named by the symbol 
COMP; the operation entry (CR) is the 
mnemonic operation code for a 
register-to-register compare operation, and 
the two operands (5, 6) designate the two 
general registers whose contents are to be 
compared. The comments entry reminds the 
programmer that he is comparing "new sum" 
to "old" with this instruction. 


r- T - T -1 

j Name |Operation|Operand | 

I-- + - + -1 

}COMP |CR J 5,6 NEW SOM TO OLD J 

L_i_J_J 
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SUMMARY OF INSTRUCTION FORMAT 


The entries in an instruction must always 
be separated by at least one blank and must 
be in the following order: name. 

Operation, operand (s), comment. 


Every statement requires an operation 
entry. Name and comment entries are 
optional. Operand entries are required for 
all machine instructions and most assembler 
instructions. 


The name and operation entries must be 
completed in the first statement line, 
including at least one blank following the 
operation entry. 

The name and operation entries must not 
contain blanks. Operand entries must not 
have blanks preceding or following the 
commas that separate them. 

A name entry must always start in the 
"begin" column. 

If the column after the end column is 
blank, the next line must start a new 
statement. If the column after the end 
column is not blank, the following line 
will be treated as a continuation line. 

All entries must be contained within the 
designated begin, end, and continue column 
boundaries. 


COMMENTS STATEMENTS 


Comments statements are used to include a 
programmer's notes on an assembly listing. 
(These notes can be helpful during 
debugging and maintenance of a program.) 
Comments statements have no effect in the 
assembled program; they are only printed in 
the assembly listing and, therefore, may 
appear at any point. Extensive notes, or 
comments, may be written by using a series 
of comments statements. 

There are two types of comments 
statements. One type, written with an 
asterisk (*) in the begin column, is used 
for comments on the source program. The 
other type, written with a period in the 
begin column and followed by an asterisk, 
is used for comments on a macro definition. 
This type is further described in Section 
7. 

An example of the comments statement is: 


t-r- t- ~r -1 

| Name JOperation}Operand | | 

J.-L--L-f-1 

1 *THIS COMMENT IS CONTINUED ON f X | 

j ANOTHER LINE. | | 

I-X-J 


IDENTIFICATION-SEQUENCE FIELD 


The identification-sequence field of the 
coding form (columns 73-80) is used to 
enter program identification and/or 
statement sequence characters. The entry 
is optional. If the field, or a portion of 
it, is used for program identification, the 
identification is punched in the statement 
cards, and reproduced in the printed 
listing of the source program. 

To aid in keeping source statements in 
order, the programmer may code an ascending 
sequence of characters in this field or a 
portion of it. These characters are 
punched into their respective cards, and, 
during assembly, the programmer may request 
the assembler to verify this sequence by 
use of the Input Sequence Checking (ISEQ) 
assembler instruction. This instruction is 
discussed in Section 5 under "Program 
Control Instructions." 


CHARACTER SET 


Source statements are written using the 
following characters: 

Letters A through Z, and $, #, a 

Digits 0 through 9 

Special 

Characters +-,=.* () ' / S blank 

These characters are represented by the 
card punch combinations and internal bit 
configurations listed in Appendix A. In 
addition, any of the 256 punch combinations 
may be designated anywhere that characters 
may appear between paired apostrophes, in 
comments, and in macro instruction 
operands. 


Assembler Language Structure 

The oasic structure of the language can be 
stated as follows. 

A source statement is composed of: 
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• A name entry (usually optional). 

• An operation entry (mandatory) . 

• An operand entry (usually 
required). 

• A comments entry (optional) . 

A name entry is: 

• A symbol. 

Ik m -w" ^ 4 ^ **%, /N ^ » 4 <s • 

mi u^ci.a uxvu cuui.^ a. o • 

• A mnemonic operation code representing 
a machine, assembler, or macro 
instruction. 

An operand entry is: 

• One or more operands composed of one 
or more expressions. An expression is 
composed of a term or an arithmetic 
combination of terms. In general, an 
operand entry should contain 50 or 
fewer terms (see Appendix H) . 

Operands of machine instructions 
generally represent such things as storage 
locations, general registers, immediate 
data, or constant values. Operands of 
assembler instructions provide the 
information needed by the assembler program 
to perform the designated operation. 

Figure 3 depicts this structure. Terms 
shown in Figure 3 are classed as absolute 
or relocatable. Terms are absolute or 


relocatable due to the effect of program 
relocation upon them. (Program relocation 
is the loading of the object program into 
storage locations other than those 
originally assigned by the assembler 
program.) A term is absolute if its value 
does not change upon relocation. A term is 
relocatable if its value changes upon 
relocation. 

The following subsection, "Terms and 
Expressions", discusses these items as 
outlined in Figure 3. 


Terms and Expressions 


TERMS 


Every term represents a value. This value 
may be assigned by the assembler program 
(symbols, symbol length attribute, location 
counter reference) or may be inherent in 
the term itself (self-defining term, 
literal) . 

An arithmetic combination of terms is 
reduced to a single value by the assembler 
program. 

The following material discusses each 
type of term and the rules for its use. 
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May be generated by combination of variable symbols and assembler language characters. 


(Conditional assembly only) 


2 


Conditional assembly only. 


Figure 3. Assembler Language Structure--Machine, Assembler, and Macro Instructions 
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S ymbols 


A symbol is a character or combination of 
characters used to represent locations or 
arbitrary values. Symbols, through their 
use in name fields and in operands, provide 
the programmer with an efficient way to 
name and reference a program element. 

There are three types of symbols: 

1. Ordinary symbols. 

2. Variable symbols. 


3. Sequence symbols. 




lV\rv1 O nAnqi cH 


letters and/or numbers, the first of which 
must be a letter. Such symbols are used to 
identify machine locations or arbitrary 
values. In the following sections, the 
occurrence of symbol refers to this type of 
term. Absolute symbols are ordinary 
symbols whose values do not change upon 
program relocation. Relocatable symbols 
are ordinary symbols whose values change 
upon relocation. 


The following are valid ordinary 
symbols: 

READER 

A23456 

X4F2 

L00P2 

N 

S4 

2B4 

$A1 

#56 

It is advisable to avoid using symbols 
beginning with IJ; they may conflict with 
IOCS symbols (which begin with IJ) . 


It is also advisable to avoid using 
symbols which are identical to a file name 
(name field) in a DTF statement with a 
single character suffix. For example, for 
the file name RECIN, IOCS generates the 
symbols: RECINl, RECIN2, RECIN3, etc. 


The following ordinary symbols are 
invalid, for the reasons noted: 

256B First character is not 

alphabetic. 

RECORDAREA2 More than eight characters. 


BCD+34 


Contains a special 
character--an asterisk. 


IN AREA 


Contains a blank. 


Variable symbols must begin with an 
ampersand (6) followed by one to seven 
letters and/or numbers, the first of which 


must be a letter. Variable symbols are 
used within the source program or macro 
definition to allow different values to be 
assigned to one symbol. A complete 
discussion of variable symbols appears in 
Part 3. 

Sequence symbols consist of a period (.) 
followed by one to seven letters and/or 
numbers, the first of which must be a 
letter. Sequence symbols are used to 
indicate the position of statements within 
the source program or macro definition. 
Through their use the programmer can vary 
the sequence in which statements are 
processed by the assembler program. (See 
the complete discussion in Part 3.) 

Note : Sequence symbols and variable 

symbols are used only for the macro 
language and for conditional assembly. 
Programmers who do not use these features 
need not be concerned with these symbols. 

DEFINING SYMBOLS : The assembler assigns a 
value to each symbol appearing as a name 
entry in a source statement. The values 
assigned to symbols naming storage areas, 
instructions, constants, and control 
sections are the addresses of the leftmost 
bytes of the storage fields containing the 
named items. Since the addresses of these 
items may change upon program relocation, 
the symbols naming them are considered 
relocatable terms. 

A symbol used as a name entry in the 
Equate Symbol (EQU) assembler instruction 
is assigned a value designated in the 
operand entry of the instruction. Since 
the operand entry may represent a 
relocatable value, or an absolute (i.e., 
nonchanging) value, the symbol is 
considered a relocatable term or an 
absolute term, depending on the value to 
which it is equated. 

The value of a symbol may not be 
negative and may not exceed 2 21t -1. 

A symbol is said to be defined when it 
appears as the name of a source statement. 
(A special case of symbol definition is 
discussed in Section 3, under "Program 
Sectioning and Linking".) 

Symbol definition also involves the 
assignment of a length attribute to the 
symbol. (The assembler maintains an 
internal table—the symbol table—in which 
the values and attributes of symbols are 
kept, when the assembler encounters a 
symbol in an operand, it refers to the 
table for the values associated with the 
symbol.) The length attribute of a symbol 
is the length, in bytes, of the storage 
field whose address is represented by the 
symbol. For example, a symbol naming an 
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instruction that occupies four bytes of 
storage has a length attribute of 4. Note 
that there are exceptions to this rule; for 
example, in the case where symbol has been 
defined by an equate to location counter 
value (EQU *) or to a self-defining term, 
the length attribute of the symbol is 1. 
These and other exceptions are noted under 
the instructions involved. The length 
attribute is never affected by a 
duplication factor. 

PREVIOUSLY DEFINED SYMBOLS ; The assembler 
language requires that symbols appearing in 
the operand entry of some instructions be 
previously defined. This simply means that 
the symbols, before their use in an 
operand, must have appeared as the name 
entry of a prior statement. For example: 


SYM1 MVC A, B 

SYM2 EQU SYM1 


would be a valid sequence of coding. The 
same two instructions in reverse order 
would be invalid. 

GENERAL RESTRICTIONS ON SYMBOLS : A Symbol 
may be defined only once in an assembly. 
While the same symbol may appear as the 
name of two or more statements before macro 
generation and conditional assembly, only 
one such statement should be generated. In 
addition, a symbol may be used in the name 
field more than once as a control section 
name (i.e., defined in the START, CSECT, or 
DSECT assembler statements described in 
Section 3) because the coding of a control 
section may be suspended and then resumed 
at any subsequent point. The CSECT or 
DSECT statement that resumes the section 
must be named by the same symbol that 
initially named the section; thus, the 
symbol that names the section must be 
repeated. Such usage is not considered to 
be duplication of a symbol definition. 


Self-Defining Terms 


A self-defining term is one whose value is 
inherent in the term. It is not assigned a 
value by the assembler program. For 
example, the decimal self-defining 
term—15—represents a value of fifteen. 

There are four types of self-defining 
terms: decimal, hexadecimal, binary, and 
character. Use of these terms is spoken of 
as decimal, hexadecimal, binary, or 
character representation of the machine 


language binary value or bit configuration 
they represent. 

Self-defining terms are classed as 
absolute terras because the values they 
represent do not change upon program 
relocation. 


USING SELF-DEFINING TERMS : Self-defining 
terms are the means of specifying machine 
values or bit configurations without 
equating the values to symbols and using 
the symbols. Self-defining terms may be 
used to specify such program elements as 
immediate data, masks, registers, 
addresses, and address increments. 

The use of a self-defining term is quite 
distinct from the use of data constants or 
literals. When a self-defining term is 
used in a machine instruction statement, 
its value is assembled into the 
instruction. When a data constant or 
literal is specified in the operand of an 
instruction, its address is assembled into 
the instruction. 


Decimal Self-Defining Term . A decimal term 
is simply an unsigned decimal number 
written as a sequence of decimal digits. 
High-order zeros may be used (e.g., 007). 
Limitations on the value of the term depend 
on its use. For example, a decimal term 
that designates a general register must 
have a value between 0 and 15 inclusively; 
one that represents an address must not 
exceed the size of storage. In any case, a 
decimal term may not consist of more than 
eight digits or exceed 16,777,215 (2 24 -1). 

A decimal term is assembled as its binary 
equivalent. Some examples of decimal 
self-defining terms are: 8, 147, 4092, 
00021 . 


Hexadecimal Self-Defining Term . A 
hexadecimal self-defining term is a 
sequence of one to six hexadecimal digits. 
The digits must be enclosed in single 
apostrophes and preceded by the letter X: 
X*C49 1 . 

Each hexadecimal digit is assembled as 
its four-bit binary equivalent. Thus* a 
hexadecimal term used to represent an 
eight-bit mask would consist of two 
hexadecimal digits. The maximum value of a 
hexadecimal term is X'FFFFFF*. 

The hexadecimal digits and their bit 
patterns are as follows: 


0- 

0000 

4- 

0100 

8- 

1000 

c- 

1100 

1- 

0001 

5- 

0101 

9- 

1001 

D- 

1101 

2- 

0010 

6- 

0110 

A- 

1010 

E- 

1110 

3- 

0011 

7- 

0111 

B- 

1011 

F- 

1111 
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A table for converting from hexadecimal 
representation to decimal representation is 
provided in Appendix B. 

Binary Self-Defining Term . A binary 
self-defining term is written as an 
unsigned sequence of 1's and 0's enclosed 
in apostrophes and preceded by the letter 
B, as follows: B'10001101*. This term 
woul d uppcsr in stcru^6 uS shown § occupying 
one byte. A binary term may have up to 24 
bits represented. Padding with binary 
zeros is on the left. 

Binary representation is used primarily 
in designating bit patterns of masks or in 
logical operations. 

The following example illustrates a 
binary term used as a mask in a Test Under 
Mask (TM) instruction. The contents of 
GAMMA are to be tested, bit by bit, against 
the pattern of bits represented by the 
binary term. 

r - T -1-1 

|Name |Operation!Operand | 

1 --+-f- \ 

IALPHA j TM jGAMMA,B*10101101' j 

i-x_x_J 

Character Self-Defining Term . A character 
self-defining term consists of one to three 
characters enclosed by apostrophes. It 
must be preceded by the letter C. All 
letters, decimal digits, and special 
characters may be used in a character term. 
In addition, any of the remainder of the 
256 punch combinations may be designated in 
a character self-defining term. Examples 
of character self-defining terms are as 
follows: 

C'/' C' * (blank) 

C' ABC * CM3' 

Because of the use of apostrophes in the 
assembler language and ampersands in the 
macro language as syntactic characters, the 
following rule must be observed when using 
these characters in a character term. 


Location Counter Reference 


A location counter is used to assign 
storage addresses to program statements. 

It is the assembler program's equivalent of 
the instruction counter in the computer. 

As each machine instruction or data area is 
assembled, the location counter is first 


“ill +■ / 

CAVA J uO VC.U 

item, if adjustment is necessary, and then 
incremented by the length of the assembled 
item. Thus, it always points to the next 
available location. If the statement is 


named by a symbol, the value assigned to 
the symbol is the value of the location 

-j-- £J-U—J Wi-X. 

wuutci ai tcx uuuiiuai.}r aujuouiicm.| x/ut 

before addition of the length. 


The assembler maintains a location 
counter for each control section of the 
program and manipulates each location 
counter as previously described. Source 
statements for each section are assigned 
addresses from the location counter for 
that section. The location counter for 
each successively declared control section 
assigns locations in consecutively higher 
areas of storage. If a program has 
multiple control sections, all statements 
identified as belonging to the first 
control section will be assigned from the 
location counter for section 1, the 
statements for the second control section 
will be assigned from the location counter 
for section 2, etc. This procedure is 
followed whether the statements from 
different control sections are interspersed 
or written in control section sequence. 


The location counter setting can be 
controlled by using the START and ORG 
assembler instructions, which are described 
in Sections 3 and 5, respectively. The 
counter affected by either of these 
assembler instructions is the counter for 
the control section in which they appear. 
The maximum value for the location counter 
is 2 2< *-1. 


For each apostrophe or ampersand desired 
in a character term, two apostrophes or 
ampersands must be written. For example, 
the character value A'# would be written as 
C'A''#', while an apostrophe followed by a 
blank and another apostrophe would be 
written as C'" *''. 

Each character in the character sequence 
is assembled as its eight-bit code 
equivalent (see Appendix A). The two 
apostrophes or ampersands that must be used 
to represent a single apostrophe or 
ampersand within the character sequence are 
assembled as a single apostrophe or 
ampersand. 


The programmer may refer to the current 
value of the location counter at any place 
in a program, by using an asterisk in an 
operand. The asterisk represents the 
location of the first byte of currently 
available storage (i.e., after any required 
boundary adjustment) . Using an asterisk in 
a machine instruction statement is the same 
as placing a symbol in the name field of 
the statement and then using that symbol as 
an operand of the statement. Because a 
location counter is maintained for each 
control section, a location counter 
reference designates the location counter 
for the section in which the reference 
appears. 
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A reference to the location counter may 
be made in a literal address constant 
(i.e., the asterisk may be used in an 
address constant specified in literal 
form). The address of the instruction 
containing the literal is used for the 
value of the location counter . A location 
counter reference may not be used in a 
statement which requires the use of a 
predefined symbol, with the exception of 
the EQU and ORG assembler instructions. 


Literals 


A literal term is one of three basic ways 
to introduce data into a program. It is 
simply a constant preceded by an equal sign 
(=). 


A literal represents data rather than a 
reference to data. The appearance of a 
literal in a source statement directs the 
assembler program to assemble the data 
specified by the literal, store this data 
in a "literal pool", and place the value 
(address) of the storage field containing 
the data in the operand field of the 
assembled statement. 

Literals provide a means of entering 
constants (such as numbers for calculation, 
addresses, indexing factors, or words or 
phrases for printing out a message) into a 
program by specifying the constant in the 
operand of the instruction in which it is 
used. This is in contrast to using the DC 
assembler instruction to enter the data 
into the program, and then using the name 
of the DC instruction in the operand. Only 
one reference to a literal is allowed in a 
machine instruction statement. 

A literal term may not be combined with 
any other terms. 

A literal may not be used as the 
receiving field of an instruction that 
modifies storage. 

A literal may not be specified in an 
address constant (see "DC—Define Constant" 
in Section 5). A literal may not be 
specified in a shift instruction or an I/O 
instruction (HIO, HDV, SIO, SIOF, STIDC, 

TIO) . 


r - 

(Name 

f- 

(GAMMA 

L_ 


T-T- 

(Operation(Operand 

4 - 4 - 

(L j10,=F*274 


T 

I 

-I 

I 

.J 


The statement GAMMA is a load 
instruction using a literal as the second 
operand. When assembled, the second 
operand of the instruction will be the 
address at which the binary value 
represented by F*274 r is stored. 

jjote ; If the type subfield of the operand 
is C, X, or B and the equal sign (=} is 
omitted, you have not written a literal but 
a self-defining term which the assembler may 
assemble without error (see "Using Self- 
Defining Terms"). 

In general, literals may be used 
wherever a storage address is permitted as 
an operand. They may not, however, be used 
in any assembler instruction. Literals are 
considered relocatable, because the address 
of the literal, rather than the literal 
itself, will be assembled in the statement 
that employs a literal. The assembler 
generates the literals, collects them, and 
places them in a specific area of storage, 
as explained in the subsection "The Literal 
Pool." A literal is not to be confused 
with the immediate data in an SI 
instruction. Immediate data is assembled 
into the instruction. 

Literal Format . The assembler requires a 
description of the type of literal being 
specified as well as the literal itself. 

This descriptive information assists the 
assembler in assembling the literal 
correctly. The descriptive portion of the 
literal must indicate the format in which 
the constant is to be assembled. It may 
also specify the length the constant is to 
occupy. 

The method of describing and specifying 
a constant as a literal is nearly identical 
to the method of specifying it in the 
operand of a DC assembler instruction. The 
major difference is that the literal must 
start with an equal sign (=) , which 
indicates to the assembler that a literal 
follows. See the discussion of the DC 
assembler instruction operand format 
(Section 5) for the means of specifying a 
literal. The type of literal designated in 
an instruction is not checked for 
correspondence with the operation code of 
the instruction. 


A literal may not have an explicit base 
or an explicit index when specified in an 
instruction. 

The instruction coded below shows one 
use of a literal. 


Some examples of literals are: 


=A (BETA) 
=F*1234 * 

^•ABC* 


address constant literal- 
a fixed-point number with a 
length of four bytes, 
a character literal. 
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The Literal Pool . The literals processed 
by the assembler are collected and placed 
in a special area called the literal pool 
and the location of the literal, rather 
than the literal itself, is assembled in 
the statement employing a literal. The 
positioning of the literal pool may be 
controlled by the programmer, if he so 
desires. Unless otherwise specified, the 
literal pool is placed at the end of the 
first control section. 


For ease in following the example, 
length attributes of A1 and B2 are 
mentioned. 

r-v--- t- 


|Name 

I-- 

1A1 

jOperation(Operand 

|DS 

|CL8 

j B 2 

j DC 

|CL2 # AB * 

| HIORD 

|MVC 

j Al (L*B2) ,B2 

J LOORD 

IMVC 

1Al+L*Al-L*B2fL*B2l 


i -i- x. 


the 



B2 


I 

I 

l 
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The programmer may also specify that 
multiple literal pools be created. 

However, the sequence in which literals are 
ordered within the pool is controlled by 
the assembler. Further information on 
positioning the literal pool (s) is in 
Section 5 under "LTORG—Begin Literal 
Pool.■ 


Duplicate Literals . If duplicate literals 
occur within one literal pool, only one 
literal is stored. Literals are considered 
duplicates only if their specifications are 
identical. A literal will be stored, even 
if it appears to duplicate another literal, 
if it is an A-type address constant 
containing any reference to the location 
counter . 


The following examples illustrate the 
foregoing rules: 


X'FOM 

0*0' J 

XL3 * 0 1 
HL3* O' 
A (*+4) 
A (*+4) 


Both are stored. 


Both are stored. 


Both are stored. 


A1 names a storage field eight bytes in 
length and is assigned a length attribute 
of eight. B2 names a character constant 
two bytes in length and is assigned a 
length attribute of two* The statement 
named HIORD moves the contents of B2 into 
the leftmost two bytes of A1. The term 
L*B2 in parentheses provides the length 
specification required by the instruction. 
When the instruction is assembled, the 
length is placed in the proper field of the 
machine instruction. 

The statement named LOORD moves the 
contents of B2 into the rightmost two bytes 
of A1. The combination of terms 
Al+L , A1-L'B2 results in the addition of the 
length of A1 to the beginning address of 
Al, and the subtraction of the length of B2 
from this value. The result is the address 
of the seventh byte in field Al. The 
constant represented by B2 is moved into Al 
starting at this address. L*B2 in 
parentheses provides length specification 
as in HIORD. 

Note : The length attribute of * is equal 
to the length of the instruction in which 
it appears, except in an EQU to * 
instruction where the length attribute is 
1. 


X * FFFF' 
X *FFFF * 


Identical; the first is stored. 


EXPRESSIONS 


Symbol Length Attribute Reference 

The length attribute of a symbol may be 
used as a term by coding L 1 followed by the 
symbol, as in: 

L* BETA 

The length attribute of BETA will be 
substituted for the term. The following 
example illustrates the use of L* symbol in 
moving a character constant into either the 
high-order or low-order end of a storage 
field. 


Expressions, which are used in coding 
operand entries for assembler language 
statements, are composed of either a single 
term or an arithmetic combination of terms 
(see Figure 3) . Arithmetically combined 
terms, enclosed in parentheses, may be use 
in combination with terms outside the 
parentheses. For example: 

14+BETA- (GAMMA-LAMBDA) 

When terms in parentheses occur in 
combination with other terms, like 
(GAMMA-LAMBDA) in the example, the 
parenthesized terms are reduced first to a 
single value. This value may be absolute 
or relocatable, depending on the 
combination of terms. This value then is 
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used in reducing the rest of the 
combination to another single value. 


Parenthesized terms may be included 
within another set of terms in parentheses. 
For example: 

A+B- (C+D- (E+F) +10) 


This expression has two levels of 
parentheses. A level of parentheses is a 
left parenthesis and its matching right 
parenthesis. One level of parentheses 
surrounds E+F. The next higher level of 
parentheses surrounds C+D-(E+F)+10. The 
innermost set of terms in parentheses (the 
lowest level) is evaluated first. 


The following are examples of valid 
expressions: 


* 

AREA1+X'2D* 

*+32 

N-25 

FIELD+332 

FIELD 

(EXIT- ENTRY+1) +GO 
=F*1234* 


BETA*10 
B* 101' 

C'ABC' 

29 

L* FIELD 

LAMBDA+GAMMA 

TEN/TWO 


ALPHA-BETA/ (10+AREA*L* FIELD) -100 
A* (A* (A* (A+1) +3* (B-3) )) 


The rules for coding expressions are: 

1. An expression may not start with an 
arithmetic operator, that is, + - / *. 
Therefore, the expression -A+BETA is 
invalid. However, the expression 
0-A+BETA is valid. 

2. An expression may not contain two 
terms or two operators in succession. 

3. An expression may not consist of more 
than 16 terms. 

4. An expression may not have more than 
five levels of parentheses. 

5. A multiterm expression may not contain 
a literal. 


Evaluation of Expressions 


A single term expression, e.g., 29, BETA, 

*, L'SYMBOL, takes on the value of the term 
involved. 

A multiterm expression, e.g., BETA+10, 
ENTRY-EXIT, 25*10+A/B, is reduced to a 
single value, as follows: 

1. Each term is given its value. 


2. Arithmetic operations are performed 
left to right. Multiplication and 
division are done before addition and 
subtraction, e.g., A+B*C is evaluated 
as A+ (B*C) , not (A+B)*C. The computed 
result is the value of the expression. 

3. Every expression is computed to 32 
bits, and then truncated to the 
rightmost 24 bits. 

4. Division always yields an integer 
result; any fractional portion of the 
result is dropped. E.g., 1/2*10 
yields a zero result, whereas 10*1/2 
yields 5. 

5. Division by zero is valid and yields a 
zero result. 

Parenthesized expressions used in an 
expression are processed before the rest of 
the terms in the expression, e.g., in the 
expression A+BETA* (CON-10), the term CON-10 
is evaluated first and the resulting value 
is used in computing the final value of the 
expression. 

Negative values are carried in two*s 
complement form. Final values of 
expressions are the rightmost 24 bits of 
the results. Intermediate results have a 
range of -2 3a through 2 3<l -1. However, the 
value of an expression before truncation 
must be in the range ~ 2 2t * through 2 2< *-1 or 
the results will be meaningless. A 
negative result is considered to be a 
3-byte positive value. 

Note : In A-type address constants, the 

full 32 bit final result is truncated on 
the left to fit the specified or implied 
length of the constant. 


Absolute and Relocatable Expressions 


An expression is called absolute if its 
value is unaffected by program relocation. 

An expression is called relocatable if 
its value changes upon program relocation. 

The two types of expressions, absolute 
and relocatable, take on these 
characteristics from the term or terms 
composing them. The following material 
discusses this relationship. 

Absolute Expression . An absolute 
expression may be an absolute term or any 
arithmetic combination of absolute terms. 

An absolute term may be an absolute symbol, 
any of the self-defining terms, or the 
length attribute reference. As indicated 
in Figure 3, all arithmetic operations are 
permitted between absolute terms. 
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An absolute expression may contain 
relocatable terms (RT)—alone or in 
combination with absolute terms (AT) —-under 
the following conditions: 


Relocatable Expressions . A relocatable 
expression is one whose value would change 
by n if the program in which it appears is 
relocated n bytes away from its originally 
assigned area of storage. 


1. There must be an even number of 

relocatable terms in the expression. 


2 . 


The relocatable terms must be paired. 




>iic oaiu< 


relocatability attribute, i.e., they 
appear in the same control section in 
this assembly (see "Program Sectioning 
and Linking", Section 3) . Each pair 
must consist of terms with opposite 
signs. The paired terms do not have 
to be contiguous, e.g., RT+AT-RT. 


3. No relocatable expression may enter 
into a multiply or divide operation. 
Thus, RT-RT*10 is invalid. However, 
(RT-RT) * 10 is valid. 


The pairing of relocatable terms (with 
opposite signs and the same relocatability 
attribute) cancels the effect of 
relocation. Therefore the value 
represented by the paired terms remains 
constant, regardless of program relocation. 
For example, in the absolute expression 
A-Y+X, A is an absolute term, and X and Y 
are relocatable terms with the same 
relocatability attribute. If A equals 50, 

Y equals 25, and X equals 10, the value of 
the expression would be 35. If X and Y are 
relocated by a factor of 100 their values 
would then be 125 and 110. However, the 
expression would still evaluate as 35 
(50-125+110=35) . 


An absolute expression reduces to a 
single absolute value. 

The following examples illustrate 
absolute expressions. A is an absolute 
term; X and Y are relocatable terms, with 
the same relocatability attribute. 


A-Y+X 

A 

A*A 

X-Y+A 

*-Y (a reference to the location counter 
must be paired with another 
relocatable term from the same control 
section, i.e., with the same 
relocatability attribute) 


A relocatable expression may be a 
relocatable term. A relocatable expression 
may contain relocatable terms—alone or in 
combination with absolute terms—-under the 
following conditions: 

1. There must be an odd number of 
relocatable terms. 

2. All the relocatable terms but one must 
be paired. Fairing is described in 
"Absolute Expression." 

3. The unpaired term must not be directly 
preceded by a minus sign. 

4. No relocatable term may enter into a 
multiply or divide operation. 

A relocatable expression reduces to a 
single relocatable value. This value is 
the value of the odd relocatable term, 
adjusted by the values represented by the 
absolute terms and/or paired relocatable 
terms associated with it. 


For example, in the expression W-X+W-10, 
W and X are relocatable terms with the same 
relocatability attribute. If initially W 
equals 10 and X equals 5, the value of the 
expression is 5. However, upon relocation 
this value will change. If a relocation 
factor of 100 is applied, the value of the 
expression is 105. Note that the value of 
the paired terms, W-X, remains constant at 
5 regardless of relocation. Thus, the new 
value of the expression, 105, is the result 
of the value of the odd term (W) adjusted 
by the values of W-X and 10. 

The following examples illustrate 
relocatable expressions. A is an absolute 
term, W and X are relocatable terms with 
the same relocatability attribute, Y is a 
relocatable term with a different 
relocatability attribute. 


Y-32+A W-X+* 

W-X+Y 

* (reference to 
location counter ) 


=F' 1234' (literal) 
A+A+W-W+Y 
W-X+W 
Y 
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Section 3. Addressing-Program Sectioning and Linking 


Addressing 

The IBM System/360 Operating System 
addressing technique requires the use of a 
base register, which contains the base 
address, and a displacement, which is added 
to the contents of the base register. The 
programmer may specify a symbolic address 
and request the assembler to determine its 
storage address in terms of a base register 
and a displacement. The programmer may 
rely on the assembler to perform this 
service for him by indicating which general 
registers are available for assignment and 
what values the assembler may assume each 
contains. The programmer may use as many 
or as few registers for this purpose as he 
desires. The only requirements are that, 
at the point of reference, a register 
containing an address from the same control 
section is available, and that this address 
is less than or equal to the address of the 
item to which the reference is being made. 
The difference between the two addresses 
may not exceed 4095 bytes. 


ADDRESSES—EXPLICIT AND IMPLIED 


An address is composed of a displacement 
plus the contents of a base register. (In 
the case of RX instructions, the contents 
of an index register are also used to 
derive the address.) 


The programmer writes an explicit 
address by specifying the displacement and 
the base register number. In designating 
explicit addresses a base register may not 
be combined with a relocatable symbol. 


He writes an implied address by 
specifying an absolute or relocatable 
address. The assembler has the facility to 
select a base register and compute a 
displacement, thereby generating an 
explicit address from an implied address, 
provided that it has been informed (1) what 
base registers are available to it and (2) 
what each contains. The programmer conveys 
this information to the assembler through 
the USING and DROP assembler instructions. 


BASE REGISTER INSTRUCTIONS 


The USING and DROP assembler instructions 
enable programmers to use expressions 
representing implied addresses as operands 
of machine instruction statements, leaving 
the assignment of base registers and the 
calculation of displacements to the 
assembler. 


In order to use symbols in the operand 
field of machine instruction statements, 
the programmer must (1) indicate to the 
assembler, by means of a USING statement, 
that one or more general registers are 
available for use as base registers, (2) 
specify, by means of the USING statement, 
what value each base register contains, and 
(3) load each base register with the value 
he has specified for it. 


Having the assembler determine base 
registers and displacements relieves the 
programmer of separating each address into 
a displacement value and a base address 
value. This feature of the assembler will 
eliminate a likely source of programming 
errors, thus reducing the time required to 
check out programs. To take advantage of 
this feature, the programmer uses the USING 
and DROP instructions described in this 
subsection. The principal discussion of 
this feature follows the description of 
both instructions. 


USING—Use Base Address Register 


The USING instruction indicates that one or 
more general registers are available for 
use as base registers. This instruction 
also states the base address values that 
the assembler may assume will be in the 
registers at object time. Note that a 
USING instruction does not load the 
registers specified. It is the 
programmer's responsibility to see that the 
specified base address values are placed 
into the registers. Suggested loading 
methods are described in the subsection 
■Programming with the USING Instruction." 
The typical form of the USING instruction 
statement is: 
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|Name jOperation)Operand 


(Sequence (USING jFrom 2-17 expressions! 
jsymbol orj (of the form v,r1, j 
jnot used j jr2,r3,...,r16 \ 
L_J._JL-J 


Operand v must be an absolute or 
relocatable expression with a value ranging 
from -2 24 to +2 24 -1. No literals are 
permitted. Operand v specifies a value 
that the assembler can use as a base 
address. The other operands must be 
absolute expressions. The operand rl 
specifies the general register that can be 
assumed to contain the base address 
represented by operand v. Operands r2 # r3, 
r4,... specify registers that can be 
assumed to contain v+4096 f v+8192 r 
v+12288,..., respectively. The values of 
the operands rl, r2, r3 ,..., r16 must be 
between 0 and 15. For example, the 
statement: 


2. Register 0 must be specified as 
operand rl. 

The assembler assumes that register 0 
contains zero. Therefore, regardless of 
the value of operand v, it calculates 
displacements as if operand v were absolute 
or relocatable zero. The assembler also 
assumes that subsequent registers specified 
in the same USING statement contain 4096, 
8192, etc. 

Note : If register 0 is used as a base 

register, the program is not relocatable, 
despite the fact that operand v may be 
relocatable. The program can be made 
relocatable by: 

1. Replacing register 0 in the USING 
statement. 

2. Loading the new register with a 
relocatable value. 

3. Reassembling the program. 


r-r-r- 1 

|Name |Operation!Operand ! 

j.-+--^ 

| JUSING |*,12,13 | 

l-i.-JL_J 


tells the assembler it may assume that the 
current value of the location counter will 
be in general register 12 at object time, 
and that the current value of the location 
counter, incremented by 4096, will be in 
general register 13 at object time. 

If the programmer changes the value in a 
base register currently being used, and 
wishes the assembler to compute 
displacement from this value, the assembler 
must be told the new value by means of 
another'USING statement. In the following 
sequence the assembler first assumes that 
the value of ALPHA is in register 9. The 
second statement then causes the assembler 
to assume that ALPHA+1000 is the value in 
register 9. 


r- t -r- 1 

| Name |Operation!Operand | 


- —T- 

jUSING 

— T - 

jALPHA,9 

— — 1 
1 

1 * 

1 

1 

| • 

I 

1 

|USING 

jALPHA+1000,9 

1 



_J 


If the programmer has to refer to the 
first 4096 bytes of storage, he can use 
general register 0 as a base register 
subject to the following conditions: 


DROP—Drop Base Register 


The DROP instruction specifies a previously 
available register that may no longer be 
used as a base register. The typical form 
of the DROP instruction statement is as 
follows: 


r- t-t-« 

| Name (Operation|Operand | 


- -f -- 

Sequence JDROP 

(Up to 16 absolute 

symbol or j 

(expressions of the 

not used j 

j form rl,r2 , 

1 

Jr3,...,r16 




The expressions indicate general 
registers previously specified in a USING 
statement that are now unavailable for base 
addressing. The following statement, for 
example, prevents the assembler from using 
registers 7 and 11: 

r- t-t-1 

jName JOperationJOperand | 

j.- 4 - 1 - \ 

j (DROP (7,11 j 

L-1- X -J 

It is not necessary to use a EROP 
statement when the base address in a 
register is changed by a USING statement; 
nor are DROP statements needed at the end 
of the source program. 


1. The value of operand v must be either 
an absolute or relocatable zero or 
simply relocatable. 


A register made unavailable by a EROP 
instruction can be made available again by 
a subsequent USING instruction. 
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PROGRAMMING WITH THE USING INSTRUCTION 


The USING (and DROP) instructions may be 
used anywhere in a program, as often as 
needed, to indicate the general registers 
that are available for use as base 
registers and the base address values the 
assembler may assume each contains at 
exect.ion time. Whenever an address is 
specified in a machine instruction 
statement, the assembler determines whether 
there is an available register containing a 
suitable base address. The USING 
instruction establishes addressability at 
assembly time, assuming that the registers 
assigned as base registers have been loaded 
with correct base addresses. Any reference 
to relocatable or absolute terms, which are 
to be assembled into the base displacement 
form, such as names in the operand of a 
machine instruction or S-type address 
constant, must come after the pertinent 
USING instruction that makes the terms 
addressable. References to terms 
relocatable or otherwise in the operand of 
an A-type or Y-type address constant do not 
have to be preceded by a USING statement. 

A register is considered available for a 
relocatable address if it was assigned a 
relocatable value that is in the same 
control section as the address. A register 
assigned an absolute value is available for 
addressing absolute locations only. In 
either case the base address is considered 
suitable only if it is less than or equal 
to the address of the item to which the 
reference is made. The difference between 
the two addresses may not exceed 4095 
bytes. In calculating the base register to 
be used, the assembler always uses the 
available register giving the smallest 
displacement. If there are two registers 
with the same value, the highest numbered 
register is used. 


r --7- t-, 


(Name 

L 

{Operation | Operand 

-L -L 

r 

| BEGIN 

T 

IBALR 

1 2,0 

J 

j USING 

l*,2 

J ALPHA 

1 

1 * 

1 • 

f 

1 

1 

J BETA 

1 

I • 

1 

1 

1 * 

1 

1 

j END 

|BEGIN 


L-L_J_I 

In the preceding sequence, the BALR 
instruction loads register 2 with the 
address of the first storage location 
immediately following. In this case, it is 
the address of the instruction named ALPHA. 
The USING instruction indicates to the 
assembler that register 2 contains this 
location. When employing this method, the 
USING instruction must immediately follow 
the BALR instruction. No other USING or 
load instructions are required if the 
location named BETA is within 4095 bytes of 
ALPHA. 

In Figure 4 the BALR and LM instructions 
load registers 2-5. The USING instruction 
indicates to the assembler that these 
registers are available as base registers 
for addressing a maximum of 16,384 
consecutive bytes of storage, beginning 
with the location named HERE. The number 
of addressable bytes may be increased or 
decreased by altering the number of 
registers designated by the USING and LM 
instructions and the number of address 
constants specified in the DC instruction. 


Note : Care must be taken when assigning 
base registers to avoid using, except under 
s peei^dr-^rfrtn^^ -^ 

1/ General registers 0, 1, 13, 14 and 15, 
( as they are used by the system. 

2. ;my~YT?gistrer~ns^t^e 

implicitly by a machine instruction. 


r-1-r-1 


|Name 

i ^ __ 

j Operation!Operand 
j. j. 

|6eG1n 

| BALR 

T2,o 

1 

j HERE 

1 

j BASEADDR 
|FIRST 

1 

|USING 
| LM 
|B 
| DC 

1 • 

1 • 

|HERE,2,3,4,5 
j3,5,BASEADDR 
(FIRST 

| A (HERE•♦■4096 ,HERE+819 2, HERE+12288) 

1 

I 

1 

|LAST 

1 

L _ _ 

I • 

1 * 

| END 

1 

1 

(BEGIN 

__j_ 

Figure 4. 

Multiple 

Base Register Assignment 
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RELATIVE ADDRESSING provided under the heading "Addressing 

External Control Sections." 


Relative addressing is the technique of 
addressing instructions and data areas by 
designating their location in relation to 
the location counter or to some symbolic 
location. This type of addressing is 
always in bytes, never in bits, words, or 
instructions. Thus, the expression *+4 
specifies an address that is four bytes 
greater than the current value of the 
location counter. In the sequence of 
instructions shown in the following 
example, the location of the CR machine 
instruction can be expressed in two ways, 
ALPHA+2 or BETA-4, because all of the 
mnemonics in the example are for 2-byte 
instructions in the RR format. 

r- t-1- 

|Name |Operation!Operand 
h-1-f- 

(ALPHA |LR j3,4 

I | CR | 4,6 

j j BCR j 1, 14 

j BETA j AR j 2,3 

L- L - L _ 


Program Sectioning and Linking 

It is often convenient, or necessary, to 
write a large program in sections. The 
sections may be assembled separately, then 
combined subsequently into one program. 

The assembler provides facilities for 
creating multisectioned programs and 
symbolically linking separately assembled 
programs or program sections. 

Sectioning a program is optional, and 
many programs can best be written without 
sectioning them. The programmer writing an 
unsectioned program need not concern 
himself with the subsequent discussion of 
program sections, which are called control 
sections. He need not employ the CSECT 
instruction, which is used to identify the 
control sections of a multisection program. 
Similarly, he need not concern himself with 
the discussion of symbolic linkages if his 
program neither requires a linkage to nor 
receives a linkage from another program. 

He may, however, wish to identify the 
program and/or specify a tentative starting 
location for it, both of which may be done 
by using the START instruction. He may 
also want to employ the dummy section 
feature obtained by using the DSECT 
instruction. 

Note : Program sectioning and linking is 

closely related to the specification of 
base registers for each control section. 
Sectioning and linking examples are 


CONTROL SECTIONS 


The concept of program sectioning is a 
consideration at coding time, assembly 
time, and load time. To the programmer, a 
program is a logical unit. He may want to 
divide it into sections called control 
sections; if so, he writes it in such a way 
that control passes properly from one 
section to another regardless of the 
relative physical position of the sections 
in storage. A control section is a block 
of coding that can be relocated, 
independently of other coding, at load time 
t without altering or impairing the operating 
j logic of the program. It is normally 
-j identified by the CSECT instruction. 

J However, if it is desired to specify a 
j tentative starting location, the START 
j instruction may be used to identify the 
j first control section. 

To the assembler, there is no such thing 
as a program; instead, there is a source 
module, which consists of one or more 
control sections. (However, the terms 
source module and program are often used 
interchangeably.) An unsectioned program 
is treated as a single control section. To 
the linkage editor, there are no programs, 
only control sections that must be 
fashioned into one or more phases. 

The output from the assembler is called 
an object module. It contains data 
required for linkage editor processing. 

The external symbol dictionary, which is 
part of the object module, contains 
information the linkage editor needs in 
order to complete cross-referencing between 
control sections, as it combines them into 
a program. The linkage editor can take 
control sections from various assemblies 
and combine them properly with the help of 
the corresponding external symbol 
dictionaries. Successful combination of 
separately assembled control sections 
depends on the techniques used to provide 
symbolic linkages between the control 
sections. 

Whether the programmer writes an 
unsectioned program, a multisection 
program, or part of a multisection program, 
he still knows what eventually will be 
entered into storage, because he has 
described storage symbolically. He may not 
know where each section appears in storage, 
but he does know what storage contains. 
There is no constant relationship between 
control sections. Thus, knowing the 
location of one control section does not 
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make another control section addressable by 
relative addressing techniques. 

There is a limit to the number of 
external symbol dictionary entries. The 
total number of control sections (named, 
unnamed, and common control sections), 
dummy sections, unique symbols in EXTRN and 
WXTRN statements, and V-type address 
constants may not exceed 255. (The V-type 
address constant is described in Section 5 
under "DC — Define Constant"; the other 
external symbols are described in this 
section.) If the same symbol appears both 
in V-type address constant and in the name 
field of a START, CSECT, or DSECT 
statement, it is counted as two symbols. 


Control Section Location Assignment 


Control section contents can be intermixed 
because the assembler provides a location 
counter for each control section. Control 
sections are assigned starting locations 
consecutively, in the same order as the 
control sections first occur in the 
program. Each control section subsequent 
to the first begins at the next available 
doubleword boundary. 


FIRST CONTROL SECTION 


The first control section of a program has 
the following special properties. 

1« The initial v^lue of its location 
counter may be specified as an 
absolute value. 

2. It normally contains the literals 
requested in the source module, 
although their positioning can be 
altered. This is further explained 
under the discussion of the LTORG 
assembler instruction. 


START—Start Assembly 


I -T-T- 

|Name (OperationJOperand 

|--j--1- 

|Any symbol |START |A self-defining 
jor not used j (term or not 

I j |used 

i-j- x __ 


If a symbol names the START instruction, 
the symbol is established as the name of 
the control section. If not, the control 
section is considered to be unnamed. All 
subsequent statements are assembled as part 
of that control section. This continues 
until an instruction identifying a 
different control section is encountered. 

A CSECT instruction named by the same 
symbol that names a START instruction is 
considered to identify the continuation of 
the control section first identified by the 
START. Similarly, an unnamed CSECT that 
occurs in a program initiated by an unnamed 
START is considered to identify the 
continuation of the unnamed control 
section. 

The symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the 
control section. It has a length attribute 
of one. 

The assembler uses the self-defining 
term specified by the operand as the 
initial value of the location counter of 
the program. This value should be 
divisible by eight. For example, either of 
the following statements: 


I-7-T- 

|Name (Operation|Operand 

|--{■--j-- 

j PR0G2 (START (2040 

j PROG2 (START (X*7F8* 


H 

I 

I 


could be used to assign the name PROG2 to 
the first control section and to set the 
initial value of the location counter to 
2040. If the operand is omitted, the 
assembler sets the initial value to zero. 
The location counter is set at the next 
doubleword boundary when the value of the 
START operand is not divisible by 8. 

Note : The START instruction may not be 
preceded by any type of assembler language 
statement that may either affect or depend 
upon the setting of the location counter. 


The START instruction may be used to give a 
name to the first (or only) control section 
of a source module. It may also be used to 
specify the initial value of the location 
counter for the first control section of 
the module. The typical form of the START 
instruction statement is as follows: 


CSECT—Identify Control Section 


The CSECT instruction identifies the 
beginning or the continuation of a control 
section. The typical form of the CSECT 
instruction statement is as follows: 
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r-r- t- 1 

|Name |Operation)Operand | 

I--f-f--I 

(Any symbol |CSECT (Not used? should | 

jor not used j (not be present j 

l_ l -J-J 

If a symbol names the CSECT instruction, 
the symbol is established as the name of 
the control section; otherwise the section 
is considered to be unnamed. All 
statements following the CSECT are 
assembled as part of that control section 
until a statement identifying a different 
control section is encountered (i.e., 
another CSECT or a DSECT instruction). 

jho symbol in the name field is a valid 
relocatable symbol whose value represents 
the address of the first byte of the 
control section. It has a length attribute 
of one. 

Several CSECT statements with the same 
name may appear within a source module. 

The first is considered to identify the 
beginning of the control section; the rest 
identify the resumption of the section. 
Thus, statements from different control 
sections may be interspersed. They are 
properly assembled (assigned contiguous 
storage locations) as long as the 
statements from the various control 
sections are identified by the appropriate 
CSECT instructions. 

Under the Tape Operating System (TOS) a 
completely empty control section (CSECT) is 
flagged in error. 


Unnamed Control Section 


If neither a named CSECT instruction nor 
START instruction appears at the beginning 
of the program, the assembler determines 
that it is to assemble an unnamed control 
section as the first (or only) control 
section. There may be only one unnamed 
control section in a program. If one is 
initiated and is then followed by a named 
control section, any subsequent unnamed 
CSECT statements are considered to resume 
the unnamed control section. If it is 
desired to write a small program that is 
unsectioned, the program does not need to 
contain a CSECT instruction. 


DSECT—Identify Dummy Section 


A dummy section represents a control 
section that is assembled but is not part 
of the object program. A dummy section is 


a convenient means of describing the layout 
of an area of storage without actually 
reserving the storage. (It is assumed that 
the storage is reserved either by some 
other part of this assembly or else by 
another assembly.) The DSECT instruction 
identifies the beginning or resumption of a 
dummy section. More than one dummy section 
may be defined per assembly, but each must 
be named. The typical form of the DSECT 
instruction statement is as follows: 


|Name joperationjOperand j 

t - + - + -j 

|An ordinary jDSECT |Not used? should | 

jsymbol or a j jnot be present j 

Ivsri ahl p I I I 

I ~ -- I I * 

| symbol | | | 

L-J_J.-J 

The symbol in the name field is a valid 
relocatable symbol whose value represents 
the first byte of the section. It has a 
length attribute of one. 

Program statements belonging to dummy 
sections may be interspersed throughout the 
program or may be written as a unit. In 
either case, the appropriate DSECT 
instruction should precede each set of 
statements. When multiple DSECT 
instructions with the same name are 
encountered, the first is considered to 
initiate the dummy section and the rest to 
continue it. 

Symbols that name statements in a dummy 
section may be used in USING instructions. 
Therefore, they may be used in program 
elements (e.g., machine instructions and 
data definitions) that specify storage 
addresses. An example illustrating the use 
of a dummy section appears subsequently 
under "Addressing Dummy Sections" in this 
section. 

Note : A symbol that names a statement in a 
dummy section may be used in an A-type 
address constant only if it is paired with 
another symbol (with the opposite sign) 
from the same dummy section. 

Dummy Section Location Assignment . A 
location counter is used to determine the 
relative locations of named program 
elements in a dummy section. The location 
counter is always set to zero at the 
beginning of the dummy section, and the 
location values assigned to symbols that 
name statements in the dummy section are 
relative to the initial statement in the 
section. 

Addressing Dummy Sections . The programmer 
may wish to describe the format of an area 
whose storage location will not be 
determined until the program is executed. 
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He can describe the format of the area in a 
dummy section, and he can use symbols 
defined in the dummy section as the 
operands of machine instructions. To 
effect references to the storage area, he 
does the following: 

1. Provides a.USING statement specifying 
both a general register that the 
assembler can assign to the machine 
instructions &s a base register and a 
value from the dummy section that the 
assembler may assume the register 
contains. 

2* Ensures that the same register is 

loaded with the actual address of the 
storage area. 

The values assigned to symbols defined 
in a dummy section are relative to the 
initial statement of the section. 


Thus, all machine instructions which 
refer to names defined in the dummy section 
will, at execution time, refer to storage 
locations y relative to the address loaded 
into the register. 

An example is shown in the following 
coding. Assume that two independent 
modules {assembly 1 and assembly 2) have 
been loaded and are to be executed as a 
single overall program. Assembly 1 is an 
input routine that places a unit record in 
a specified area of storage, and places the 
address of that area in register 3. The 
input area is aligned on a fullword 
boundary. Then assembly 1 branches to 
assembly 2. Assembly 2 processes the 
record, which has the following format: 


Columns 

1 

2 

3 and 4 
5 through 8 


Content 

INCODE 

blank 

INPUTA 

INPUTB 


The coding shown in the example is from 
assembly 2. 


The input area is described in assembly 
2 by the DSECT control section named 
INAREA, portions of the input area (i.e., 
record) that the programmer wishes to work 
with are named in the DSECT control section 
as shown. The assembler instruction USING 
INAREA,3 designates general register 3 as 
the base register to be used in addressing 
the DSECT control section, and that general 
register 3 is assumed to contain the 
address of INAREA. 


Assembly 1, during execution, loads the 
actual beginning address of the input area 
in general register 3. Because the symbols 
used in the DSECT section are defined 
relative to the initial statement in the 


section, the address values they represent, 
will, at the time of program execution, be 
the actual storage locations of the input 
area. 


r ~ 

Name 

|Operation|Operand 

.J. J. 

ASMBLY2ICSECT 

T 

1 

BEGIN 

| BALR 

1 2,0 


|USING 

| • 

|*,2 

1 


| • 

j USING 

1 

jINAREA,3 


| CLI 

|INCODE,C*A* 


J BE 

1 • 

jATYPE 

1 

ATYPE 

1 • 

|MVC 

1 

jWORKA,INPUTA 


|MVC 

jWORKB,INPUTB 
j 


| CNOP 

1 2,4 

WORKA 

|DS 

H 

WORKB 

|DS 

| • 

|F 

1 

INAREA 

| • 

|DSECT 

I 

l 


j CNOP 

10,4 

INCODE 

|DS 

|CL1 


|DS 

|CL1 

INPUTA 

|DS 

H 

INPUTB 

|DS 

|F 

1 


| END 

1 

1 



-L_ _ _ _ _ 


The programmer must ensure that a 
section of code in his program is actually 
described by the dummy section which 
references it i.e., that data is properly 
aligned in both places. The DSECT named 
INAREA in the previous example adequately 
describes,the section of code introduced 
into assembly 1, as it was aligned on a 
fullword boundary. Further, WORKA and 
WORKB will be aligned and contiguous to 
each other in the same way as INPUTA and 
INPUTB are. 


COM—Define Blank Common Control Section 


The COM assembler instruction identifies 
and reserves a common area of storage that 
may be referred to by independent modules 
that have been linked and loaded for 
execution as one overall program. 

Only one blank common control section 
may be designated in a source module. 
However, more than one COM statement may 
appear within a module. The first 
identifies the beginning of the blank 
common control section; the rest identify 
the resumption of the section. 
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When several modules are loaded, each 
designating a common control section, the 
amount of storage reserved is equal to the 
longest common control section. The form 
is: 


r- r - r -•, 

|Name |Operation!Operand | 

j.-f-f-^ 

{Sequence |COM |Not used; should 1 

jsymbol orj jnot be present j 

jnot used j j j 

L-A-A-J 

The common area may be broken up into 
subfields through use of the DS and DC 
assembler instructions. Names of subfields 
are defined relative to the beginning of 
the common section, as in the DSECT control 
section. 

It is necessary to establish 
addressability relative to a named 
statement within COM since the COM 
statement itself cannot have a name. In 
the following example, addressability to 
the common area of storage is established 
relative to the named statement XYZ. 


jName jOperation(Operand 
|-- f - f - 


| L | 8,=A (XYZ) 

[USING j XYZ,8 

jMVC | PDQ (16) , = 4C'ABCD* 


[XYZ 
I PDQ 


j COM 

|DS 

IDS 


16F 

16C 


l-A-A_J 


No instructions or constants appearing 
in a common control section are assembled. 
Data can only be placed in a common control 
section through execution of the program. 

If the assignment of common storage is 
done in the same manner by each independent 
assembly, reference to a location in the 
common area by any assembly results in the 
same location being referenced. When the 
blank common control section is assembled 
the initial value of the location counter 
is set to zero. 


SYMBOLIC LINKAGES 


Symbols may be defined in one module and 
referred to in another, thus effecting 
symbolic linkages between independently 


assembled program sections. The linkages 
can be effected only if the assembler is 
able to provide information about the 
linkage symbols to the linkage editor, 
which resolves these linkage references. 

The assembler places the necessary 
information in the external symbol 
dictionary on the basis of the linkage 
symbols identified by, e.g., the ENTRY and 
EXTRN instructions. Note that these 
symbolic linkages are described as linkages 
between independent modules; more 
specifically, they are linkages between 
independently assembled control sections. 

In the module where the linkage symbol 
is defined (i.e., used as a name), it must 
also be identified to the linkage editor 
and assembler by means of the ENTRY 
assembler instruction (unless the symbol is 
the name of a CSECT or START statement). 

It is identified as a symbol that names an 
entry point, which means that another 
module may use that symbol in order to 
effect a branch operation or a data 
reference. The assembler places this 
information in the external symbol 
dictionary. 

Similarly, the module that uses a symbol 
defined in some other module must identify 
it by the EXTRN or WXTRN assembler 
instruction. Since the definition of the 
symbol appears in another module, the 
assembler arbitrarily assigns a length 
attribute of 1 and a value of 0. The 
assembler places this information in the 
external symbol dictionary. 

Another way to obtain symbolic linkages 
is by using the V-type address constant. 

The subsection "Data Definition 
Instructions" in Section 5 contains the 
details pertinent to writing a V-type 
address constant. It is sufficient here to 
note that this constant may be considered 
an indirect linkage point. It is created 
from an externally defined symbol, but that 
symbol does not have to be identified by an 
EXTRN or WXTRN statement. The V-type 
address constant is intended to be used 
for external branch references (i.e., for 
effecting branches to other programs). 
Therefore, it should not be used for 
external data references (i.e., for 
referring to data in other modules). 


ENTRY—Identify Entry Point Symbol 


The ENTRY instruction identifies linkage 
symbols that are defined in the module 
where the ENTRY instruction appears. These 
symbols can be referred to in other 
modules. 
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|Name 

F-H 

|Sequence | 
jsymbol or| 
|not used j 


|Operation|Operand 
-+-+- 


ENTRY |One or more reloca- 
j table symbols, 
j separated by 
jcommas, that also 
jappear as state- 
jment names 

_x_ 


j Name j Operation|Operand 

I--+-+- 

| j EXTRN j RATEBL,PAYCALC 

j IEXTRN IWITHCALC 


An example that employs the EXTRN 
instruction appears subsequently under 
"Addressing External Control Sections.' 


A source module may contain a maximum of 
100 ENTRY symbols. ENTRY symbols which are 
not defined (not appearing as statement 
names) , although invalid, will also count 
towards this maximum. 

An ENTRY statement operand may not 
contain a symbol defined in a dummy section 
or in a blank common control section. An 
ENTRY statement containing a symbol defined 
in an unnamed control section can be 
processed by the assembler, but the DOS/TOS 
Linkage Editor will not process the 
resulting deck. The following example 
identifies the statements named SINE and 
COSINE as entry points to the program. 

r- t-t- 1 

|Name (Operation(Operand | 

F-+--+- ^ 

j jENTRY (SINE,COSINE j 

i_x-x_j 


Note 1 : A V-type address constant does not 
hav§ to be identified by an EXTRN 
statement. 

Note 2 : Only one external symbol may be 
used in an expression. 


Addressing External Control Sections 


A common way for a program to link to an 
external control section is to: 

1. Create a V-type address constant with 
the name of the external symbol. 

2. Load the constant into a general 
register and branch to the control 
section via the register. 


Note : Labels of START and CSECT statements 
are automatically treated as entry points 
to a module. Thus they need not be 
identified by ENTRY statements. 


EXTRN—Identify External Symbol 


The EXTRN instruction identifies linkage 
symbols used by one source module but 
identified in another module. Each 
external symbol must be identified. This 
includes symbols that refer to control 
section names. The format of the EXTRN 
statement is: 

r- T - T -, 

(Name |Operation|Operand j 

F-+-+- i 

(Sequence (EXTRN (One or more relocata-J 
(symbol orj jble symbols, separ- j 

I not used | jated by commas. | 

i---x_x-j 


Name 

L 

T---T~ ---— 

(Operation | Operand 

J. J. 

T 

MAINPROG CSECT 

T 

1 

BEGIN 

| BALR 

(2,0 


| USING 

I • 

J*,2 

1 


1 • 

|L 

1 

j3,VCON 

1 

(BALR 

! • 

(1,3 

1 

VCON 

I* 

(DC 

1 

|V (SINE) 


j END 

.X-- 

| BEGIN 

_L __ _ 


The combined number of control sections 
and dummy sections plus the number of 
unique symbols in EXTRN or WXTRN statements 
and V-type address constants may not exceed 
255. (EXTRN and WXTRN statements are 
discussed in this section; V-type constants 
in Section 5 under "DC—Define Constant.") 
If the same symbol appears in a V-type 
address constant and in the name entry of a 
CSECT or DSECT statement, it is counted as 
two symbols. 


The symbols in the operand field may not 
appear as names of statements in the 
module. The following example identifies 
three external symbols that have been used 
as operands in the module but are 
identified in some other module. 


For example, to link to the control 
section named SINE, the preceding coding 
might be used. 

An'external symbol naming data may be 
referred to as follows: 
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1 . 


Identify the external symbol with the WXTRN—Identify Weak External Symbol 

EXTRN instruction, and create an 
address constant from the symbol. 

(DOS Assembler 14K D only) 


2. Load the constant into a general 
register, and use the register for 
base addressing. 


For example, to use an area named 
RATETBL, which is in another control 
section, the following coding might be 
used: 


—-- T - 

iiaiu’c | v^cxa u 

-j. 

- — T — -- - 

4 i 

xvii j v^vi.aiiu 

i . 

MAINPROG j CSECT 

t ■ — 

l 

BEGIN j BALR 

I 2,0 

j USING 

|*,2 

1 • 

1 

| • 

I 

|EXTRN 

j RATETBL 

I* 

1 

1 • 

I 

|L 

j 4,RATEADDR 

1 USING 

jRATETBL,4 

| A 

j 3, RATETBL 

I* 

! 

| • 

1 

RATEADDRJ DC 

j A (RATETBL) 

j END 

jBEGIN 

__ x _ 

_ x __ _ 


The WXTRN statement has the same format and 
almost the same use as the EXTRN statement. 
The only difference is that WXTRN 
suppresses the AUTOLINK function of the 
linkage editor for the symbols identified 
by it. Its format is: 


r- T - T -, 

{Name |Operation|Operand | 

t- + -+-4 

I I UVfTDM I 

I UCVjlUCllV^C | VVilXXUI I V1IC Vi. iUVJLC i.cj.vvav | 

Jsymbol orj jable symbols, separ- j 

jnot used j jated by commas. { 

i _ x _Jl_J 


The AUTOLINK (automatic library look-up) 
function searches the relocatable library 
for any unresolved external references. If 
it finds the external reference, it 
includes the module where the reference 
appears in the phase produced by the 
linkage editor. Any address constant 
containing an unresolved weak external 
symbol will appear (at program execution 
time) as though the value of the symbol was 
resolved to zero. 


/ For more detailed information on 
'AUTOLINK refer to DOS System Control and 
Service. 


Note : AUTOLINK will be suppressed for a 
symbol defined both in a V-type address 
constant and in a WXTRN statement. 
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Section 4. Machine Instructions 


This section discusses the coding of the 
machine instructions represented in the 
assembler language. The reader is reminded 
that the functions of each machine 
instruction are discussed in the 
■Principles of Operation" manual (see 
"Preface"). 


Machine Instruction Statements 


Machine instructions may be represented 
symbolically as assembler language 
statements. The symbolic format of each 
varies according to the actual machine 
instruction format, of which there are 
five: RR, RX, RS, SI, and SS. Within each 
basic format, further variations are 
possible. 

The symbolic format of a machine 
instruction is similar to, but does not 
duplicate, its actual format. Appendix C 
illustrates machine format for the five 
classes of instructions. A mnemonic 
operation code is written in the operation 
field, and one or more operands are written 
in the operand field. Comments may be 
appended to a machine instruction statement 
as previously explained in Section 1. 

Any machine instruction statement may be 
named by a symbol, which other assembler 
statements can use as an operand. The 
value attribute of the symbol is the 
address of the leftmost byte assigned to 
the assembled instruction. The length 
attribute of the symbol depends on the 
basic instruction format, as follows: 

Basic Format Length Attribute 


RR 2 

RX 4 

RS 4 

SI 4 

SS 6 


INSTRUCTION ALIGNMENT AND CHECKING 


All machine instructions are aligned 
automatically by the assembler on halfword 
boundaries. If any statement that causes 
information to be assembled requires 
alignment, the bytes skipped are filled 
with hexadecimal zeros. All expressions 
that specify storage addresses are checked 
to insure that they refer to appropriate 


boundaries for the instructions in which 
they are used. Register numbers are also 
checked to make sure that they specify the 
proper registers, as follows: 

1. Floating-point instructions must 
specify floating-point registers 0, 2, 
4, or 6. 

2. Double-shift, fullword multiply, and 
divide instructions must specify an 
even-numbered general register in the 
first operand. 

3. Extended precision floating-point 
instructions must specify floating 
point register 0 or 4. 


OPERAND FIELDS AND SUBFIELDS 


Some symbolic operands are written as a 
single field and other operands are written 
as a field followed by one or two 
subfields. For example, addresses consist 
of the contents of a base register and a 
displacement. An operand that specifies a 
base and displacement is written as a 
displacement field followed by a base 
register subfield, as follows: 40(5). In 
the RX format, both an index register 
subfierd and a base register subfield are 
written as follows: 40(3,5). In the SS 
format, both a length subfield and a base 
register subfield are written as follows: 

40 (21,5) . 

Appendix C shows two types of addressing 
formats for RX, RS, SI, and SS 
instructions. In each case, the first type 
shows the method of specifying an address 
explicitly, as a base register and 
displacement. The second type indicates 
how to specify an implied address as an 
expression. 

For example, a load multiple instruction 
(RS format) may have either of the 
following symbolic operands: 

R1,R3,D2(B2)—explicit address 
R1,R3,S2—implied address 

Whereas D2 and B2 must be represented by 
absolute expressions, S2 may be represented 
either by a relocatable or an absolute 
expression. 

In order to use implied addresses, the 
following rules must be observed: 
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1. The base register assembler 
instructions (USING and DROP) must be 
used. 

2. An explicit base register designation 
must not accompany the implied 
address. 


of two subfields that are separated by a 
comma and enclosed by parentheses, the 
following rules apply: 

1. If both subfields are omitted, the 
separating comma and the parentheses 
must also be omitted. 


For example, assume that FIELD is a 
relocatable symbol, which has been assigned 


./a T/inn 


noouiuc uxov 


> 1 ^ V> •*> ^ 1>% >« 


assembler has been notified (by a USING 
instruction) that general register 12 
currently contains a relocatable value of 
4096 and is available as a base register. 
The following example shows a machine 
instruction statement as it would be 
written in assembler language and as it 
would be assembled. Note that the value of 
D2 is the difference between 7400 and 4096 
and that X2 is assembled as zero, since it 
was omitted. The assembled instruction is 
presented in hexadecimal: 


Assembler statement: 


L 2,48(4,5) 

L 2,FIELD (implied address) 

2. If the first subfield in the sequence 
is omitted, the comma that separates 
it from the second subfield is 
written. The parentheses must also be 
written. 

MVC 32 (16,5) ,FIELD2 

MVC 32 (, 5) ,FIELD2 (implied length) 

3. If the second subfield in the sequence 
is omitted, the comma that separates 
it from the first subfield must be 
omitted. The parentheses must be 
written. 


ST 4,FIELD 

Assembled instruction: 

Op. Code Rl X2 B2 D2 
50 4 0 C CE8 

An address may be specified explicitly 
as a base register and displacement (and 
index register for RX instructions) by the 
formats shown in the first column of Figure 
5. The address may be specified as an 
implied address by the formats shown in the 
second column. Observe that the two 
storage addresses required by the SS 
instructions are presented separately; an 
implied address may be used for one while 
an explicit address is used for the other. 

r-1-1-1 


|Type 

j 

j Explicit 

. i . 

Address)Implied Address 
1 

[rX 

I 

j D2 (X2,B2) 

r 

j S2 (X2) 

1 

|D2 (,B2) 

| S2 

|RS 

j D2 (B2) 

| S2 

|SI 

1D1 (B1) 

IS 1 

jss 

jD 1 (Li ,B 1) 

1 SI (LI) 

1 

|D1 (L ,B 1) 

1 SI (L) 

1 

1 __ 

jD2 (L2,B2) 
- J. 

j S2 (L2) 

L 


Figure 5. Details of Address Specification 


A comma must be written to separate 
operands. Parentheses must be written to 
enclose a subfield or subfields, and a 
comma must be written to separate two 
subfields within parentheses. When 
parentheses are used to enclose one 
subfield, and the subfield is omitted, the 
parentheses must be omitted. In the case 


MVC 32 (16,5) ,FIELD2 
MVC FIELD 1 (16) , FIELD2 
(implied address) 

Fields and subfields in a symbolic 
operand may be represented either by 
absolute or by relocatable expressions, 
depending on what the field requires. (An 
expression has been defined as consisting 
of one term or a series of arithmetically 
combined terms.) Refer to Appendix C for a 
detailed description of field requirements. 

Note : Blanks may not appear in an operand 

unless provided by a character 
self-defining term or a character literal. 
Thus, blanks may not intervene between 
fields and the comma separators, between 
parentheses and fields, etc. 


LENGTHS--EXPLICIT AND IMPLIED 


The length field in SS instructions can 
be explicit or implied. To imply a lengtn, 
the programmer omits a length field from 
the operand. The omission indicates that 
the length field is either of the 
following: 

1. The length attribute of the expression 
specifying the displacement, if an 
explicit base and displacement have 
been written. 

2. The length attribute of the expression 
specifying the effective address, if 
the base and displacement have been 
implied. 
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In either case, the length attribute for 
an expression is the length of the leftmost 
term in the expression. The length 
attribute of asterisk (*) is equal to the 
length of the instruction in which it 
appears, except that in an EQU to * 
statement, the length attribute is 1. 

By contrast, an explicit length is 
written by the programmer in the operand as 
an absolute expression. The explicit 
length overrides any implied length. 

Whether the length is explicit or 
implied, it is always an effective length. 
The value inserted into the length field of 
the assembled instruction is one less than 
the effective length in the machine 
instruction statement. 

Note : If a length field of zero is 

desired, the length may be stated as zero 
or one. 

To summarize, the length required in an 
SS instruction may be specified explicitly 
by the formats shown in the first column of 
Figure 6 or may be implied by the formats 
shown in the second column. Observe that 
the two lengths required in one of the SS 
instruction formats are presented 
separately. An implied length may be used 
for one while an explicit length is used 
for the other. 


jExplicit Length 

F- 

JD1 (LI ,B 1) 

|S1 (LI) 

ID1 (L,B1) 

| SI (L) 

|D2 (L2,B2) 
j S2 (L2) 


Implied Length 


D1 (, B1) 

SI 

D1 (,B1) 

51 

D2 (,B2) 

52 


Figure 6. Details of Length Specification 
in SS Instructions 


Machine Instruction Mnemonic Codes 


represents Move. The function may be 
further defined by a modifier. For 
example, the modifier L indicates a logical 
function, as in AL for Add Logical and MV 
is modified by C (MVC) to indicate Move 
Characters. 

Mnemonic codes for functions involving 
data usually indicate the data types, by 
letters that correspond to those for the 
data types in the DC assembler instruction 
(see Section 5) . Furthermore, letters U, 

W, and X have been added to indicate short 
unnormalized, long unnormalized, and 
extended floating point operations, 
respectively. For example, AE indicates 
Add Normalized Short, whereas AU indicates 
Add Unnormalized Short. Where applicable, 
fullword fixed-point data is implied if the 
data type is omitted. 

The letters R and I are added to the 
codes to indicate, respectively, RR and SI 
machine instruction formats. Thus, AER 
indicates Add Normalized Short in the RR 
format. Functions involving character and 
decimal data types imply the SS format. 


MACHINE INSTRUCTION EXAMPLES 


The examples that follow are grouped 
according to machine instruction format. 
They illustrate the various symbolic 
operand formats. All symbols employed in 
the examples must be assumed to be defined 
elsewhere in the same assembly. All 
symbols that specify register numbers and 
lengths must be assumed to be equated 
elsewhere to absolute values. 

Implied addressing, control section 
addressing, and the function of the USING 
assembler instruction are not considered 
here. For discussion of these 
considerations and for examples of coding 
sequences that illustrate them, refer to 
"Program Sectioning and Linking", and "Base 
Register Instructions" in Section 3. 


The mnemonic operation codes (shown in 
Appendix D) are designed to be easily 
remembered codes that indicate the 
functions of the instructions. The normal 
format of the code is shown below; the 
items in brackets are not necessarily 
present in all codes: 

Verb [Modifier] [Data Type] [Machine Format] 

The verb, which is usually one or two 
characters, specifies the function. For 
example, A represents Add, and MV 


RR Format 


"T-T- 

|Operation|Operand 


Name 


|- 

j ALPHA1 |LR 
|ALPHA2 |LR 
j BETA |SPM 

jGAMMA1 jSVC 
j GAMMA2 jSVC 


H 


11,2 

|REG1 ,REG2 
115 
1250 
| TEN 
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SI Fermat 


The operands of ALPHAl, BETA, and GAMMA1 
are decimal self-defining values, which are 
categorized as absolute expressions. The 
operands of ALPHA2 and GAMMA2 are symbols 
that are equated elsewhere to absolute 
values. 


RX Format 


r— ^ 

T- 

r 


(Name 

1 

|Operation!Operand 

i i 

! 

i 

1 

1 AT/PHA 1 

1 T. 

j 1 .14 (4.10) 

i 

i 

|aLPHA2 

\L 

j REG 1,39 (4,TEN) 

i 

j BETA1 

|L 

j 2 , ZETA (4) 

i 

| BETA2 

|L 

| REG2 , ZETA (REG 4) 

i 

j GAMMA1 

1 L 

j 2,ZETA 

i 

j GAMMA2 

1 L 

| REG2,ZETA 

i 

jGAMMA3 

|L 

|2,=F * 1000' 

i 

jLAMBDA1 

|L 

! 3,20 (, 5) 

i 

L__ 

X__ 

__ 1 _ _ _ . 

_ j 

Both 

alpha 

instructions specify 

explicit 


addresses; REG1 and TEN are absolute 
symbols. Both BETA instructions specify 
implied addresses, and both use index 
registers. Indexing is omitted from the 
GAMMA instructions. GAMMA 1 and GAMMA2 
specify implied addresses. The second 
operand of GAMMA3 is a literal. LAMBDA1 
specifies no indexing. 


RS Format 


r- t-1-1 

| Name |Operation!Operand | 

f- + -+-1 

jALPHA1 jBXH j 1,2,20 (14) j 

(ALPHA2 j BXH j REG 1 ,REG2,20 (REGD) j 

jALPHAS jBXH jREG 1,REG2,ZETA | 

jALPHA4 jSLL |REG2,15 | 

JALPHA5 j SLL JREG2,0(15) | 

L-X-X-J 


Whereas ALPHAl and ALPHA2 specify 
explicit addresses, ALPHA3 specifies an 
implied address. ALPHA4 is a shift 
instruction shifting the contents of REG2 
left 15 bit positions. ALPHA5 is a shift 
instruction shifting the contents of REG2 
left by the value contained in general 
register 15. 


r -7- T -1 

| Name (Operation|Operand | 


r - - 

(ALPHAl 

r - - 

| CL I 

" T ~ -- 

j 40 (9) ,X* 40 ' 

( 

j ALPHA2 

j CLI 

(40 (REG9) ,TEN 

1 

j EETAl 

j CLI 

j ZETA,TEN 

1 

IBETA2 

1 CLI 

1ZETA,C'A' 

1 

j GAMMA 1 

jsio 

j 4 0 (9) 

i 

|GAMMA2 

|SIC 

(0 (9) 

i 

j GAMMA3 

jsio 

|40(0) 

i 

|GAMMA4 

|SIO 

| ZETA 

i 

L_ 

_x__ 

_l____ 


The 

ALPHA instructions and GAMMA1 

-GAMMA3 

specify 

explicit 

addresses, whereas 

the 


BETA instructions and GAMMA4 specify 
implied addresses. GAMMA2 specifies a 
displacement of zero. GAMMA3 dees not 
specify a base register. 


SS Format 


| Name |Operation|Operand | 


r ~ - 

| ALPHAl 

I- ~ 

(AP 

(40 (9,8) ,30 (6 ,7) 


j ALPHA2 

j AP 

j40 (NINE,REG8) ,30(L6,7) 


J ALPHA3 

(AP 

|FIELD2,FIELD 1 


j ALPHA4 

| AP 

(FIELD2 (9) ,FIELD 1 (6) 


j EETA 

j AP 

jFIELD2 (9) ,FIELD 1 


jGAMMA1 

(MVC 

(40 (9,8) ,30 (7) 


|GAMMA2 

(MVC 

(40 (NINE,REG8) ,DEC (7) 


j GAMMA3 

(MVC 

(FIELD2,FIELD 1 


j GAMMA4 

(MVC 

(FIELD2 (9) ,FIELD 1 


l-- 

-X- 

X_ --- 

_j 

ALPHAl, ALPHA2 

, GAMMAl, and GAMMA2 


specify explicit 

lengths and addresses. 



ALPHA3 and GAMMA3 specify both implied 
length and implied addresses. ALPHA4 and 
GAMMA4 specify explicit length and implied 
addresses. BETA specifies an explicit 
length for FIELD2 and an implied length for 
FIELD1; both addresses are implied. 


Extended Mnemonic Codes 


For the convenience of the programmer, the 
assembler provides extended mnemonic codes, 
which allow conditional branches to be 
specified mnemonically as well as through 
the use of the BC machine instruction. 

These extended mnemonic codes specify both 
the machine branch instruction and the 
condition on which the branch is to occur. 
The codes are not part of the universal set 
of machine instructions, but are translated 
by the assembler into the corresponding 
operation and condition combinations. 
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Extended Code 

Meaning 

Machine Instruction 

B 

D2 (X2,B2) 

Branch 

Unconditional 

BC 

15 ,D2 (X2,B2) 

BR 

R2 

Branch 

Unconditional (RR format) 

BCR 15,R2 

NOP 

D2 (X2,B2) 

No Operation 

BC 

0 ,D2 (X2,B2) 

NOPR 

R2 

No Operation (RR format) 

BCR 0,R2 


Used After 

Compare Instructions 



BH 

D2 (X2,B2) 

Branch 

on High 

BC 

2 ,D2 (X2,B2) 

BL 

D2 (X2,B2) 

Branch 

on Low 

BC 

4 ,D2 (X2,B2) 

BE 

D2 (X2,B2) 

Branch 

on Equal 

BC 

8 ,D2 (X2,B2) 

BNH 

D2 (X2,B2) 

Branch 

on Not High 

BC 

13,D2 (X2,B2) 

BNL 

D2 (X2,B2) 

Branch 

on Not Low 

BC 

11,D2 (X2,B2) 

BNE 

D2 (X2,B2) 

Branch 

on Not Equal 

BC 

7 ,D2 (X2,B2) 


Used After 

Arithmetic 

Instructions 



BO 

D2 (X2,B2) 

Branch 

on Overflow 

BC 

1 ,D2 (X2,B2) 

BP 

D2 (X2,B2) 

Branch 

on Plus 

BC 

2 ,D2 (X2,B2) 

BM 

D2 (X2,B2) 

Branch 

on Minus 

BC 

4 ,D2 (X2,B2) 

BZ 

D2 (X2,B2) 

Branch 

on Zero 

BC 

8,D2 (X2,B2) 

BNP 

D2 (X2,B2) 

Branch 

on Not Plus 

BC 

13 ,D2 (X2,B2) 

BNM 

D2 (X2,B2) 

Branch 

on Not Minus 

BC 

11 ,D2 (X2,B2) 

BNZ 

D2 (X2,B2) 

Branch 

on Not Zero 

BC 

7 ,D2 (X2,B2) 


Used After 

Test Under 

Mask Instructions 



BO 

D2 (X2,B2) 

Branch 

if Ones 

BC 

1 ,D2 (X2,B2) 

BM 

D2 (X2,B2) 

Branch 

if Mixed 

BC 

4 ,D2 (X2,B2) 

BZ 

D2 (X2,B2) 

Branch 

if Zeros 

BC 

8 ,D2 (X2,B2) 

BNO 

D2 (X2,B2) 

Branch 

if Not Ones 

BC 

14, D2 (X2 , B2) 


I-1 

Figure 7. Extended Mnemonic Codes 


The allowable extended mnemonic codes 
and their operand formats are shown in 
Figure 7, together with their machine 
instruction equivalents. Unless otherwise 
noted, all extended mnemonics shown are for 
instructions in the RX format. Note that 
the only difference between the operand 
fields of the extended mnemonics and those 
of their machine instruction equivalents is 
the absence of the R1 field and the comma 
that separates it from the rest of the 
operand field. The extended mnemonic list, 
like the machine instruction list, shows 
explicit address formats only. Each 
address can also be specified as an implied 
address. 


In the following examples, which 
illustrate the use of extended mnemonics, 
it is to be assumed that the symbol GO is 
defined elsewhere in the program. 


jName [OperationjOperand j 

y - 1 - 4 - 1 

I IB 140 (3,6) | 

I | B |40(,6) | 

| | BL |G0(3) | 

j |BL j GO j 

j j BR j 4 j 

| j NOP I GO (3) j 


The first two instructions specify an 
unconditional branch to an explicit 
address. The address in the first case is 
the sum of the contents of base register 6, 
the contents of index register 3, and the 
displacement 40; the address in the second 
instruction is not indexed. The third 
instruction specifies a branch on low to 
the address implied by GO as indexed by the 
contents of index register 3; the fourth 
instruction does not specify an index 
register. The next instruction is an 
unconditional branch to the address 
contained in register 4. The last 
instruction is a "no operation". It will 
not branch under any condition because the 
mask field is zero. 
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Section 5. Assembler Instruction Statements 


Just as machine instructions are used to 
request the computer to perform a sequence 
of operations during program execution 
time, so assembler instructions are 
requests to the assembler to perform 
certain operations during the assembly. 
Assembler instruction statements, in 
contrast to machine instruction statements, 
do not always cause machine instructions to 
be included in the assembled program. 

Some, such as DS and DC, generate no 
instructions but do cause storage areas to 
be set aside for constants and other data. 
Others, such as EQU and SPACE, are 
effective only at assembly time; they 
generate nothing in the assembled program 
and have no effect on the location counter. 

The following is a list of all the 
assembler instructions. 

Symbol Definition Instruction 
EQU Equate Symbol 

Data Definition Instructions 
DC Define Constant 

DS Define Storage 

CCW Define Channel Command Word 

Program Sectioning and Linking Instructions 1 
START Start Assembly 

CSECT Identify Control Section 

DSECT Identify Dummy Section 

ENTRY Identify Entry-Point Symbol 

EXTRN Identify External Symbol 

WXTRN Identify Weak External Symbol 

COM Identify Blank Common Control 

Section 

Base Register Instructions 1 
USING Use Base Address Register 

DROP Drop Ease Address Register 

Listing Control Instructions 

TITLE Identify Assembly Output 

EJECT Start New Page 

SPACE Space Listing 

PRINT Print Optional Data 

Program Control Instructions 

ICTL Input Format Control 

ISEQ Input Sequence Checking 

ORG Set Location Counter 

LTORG Eegin Literal Pool 

CNOP Conditional No Operation 

COPY Copy Predefined Source Coding 

END End Assembly 

PUNCH Punch a Card 

REPRO Reproduce Following Card 


Discussed in Section 3. 


Symbol Definition Instruction 


EQU--EQUATE SYMBOL 


The EQU instruction is used to define a 
symbol by assigning to it the length, 
value, and relocatability attributes of an 
expression in the operand field. The 
typical form of the EQU instruction 
statement is as follows; 


1-- — 

|Name 

L 

"T -~ T ~~ 

(Operation J Operand 
j. j. 

1 

|A variable 

I EQU 

T 

|An expression 

jsymbol or 

1 

1 

jan ordinary 

1 

1 

j symbol 

i_ _ — _ 

1 

~L _ 

1 


The expression in the operand field may 
be absolute or relocatable. Any symbols 
appearing in the expression must be 
previously defined. 

The symbol in the name field is given 
the same attributes as the expression in 
the operand field. The length attribute of 
the symbol is that of the leftmost (or 
only) term of the expression. When that 
term is * or a self-defining term, the 
length attribute is 1. The value attribute 
of the symbol is the value of the 
expression. 

The EQU instruction is the means of 
equating symbols to register numbers, 
immediate data, and other arbitrary values. 
The following examples illustrate how this 
might be done; 


i- 

| Name 

■ 1 - - T -- 

|Operation | Operand 

. j. -i 

' —i 
1 

_j 

j REG2 
j TEST 

L__ 

! EQU 
|EQU 

-X- - 

T 

|2 (general register) 
jX*3F 1 (immediate data) 

1 

1 

1 

__j 


To reduce programming time, the 
programmer can equate symbols to frequently 
used expressions and then use the symbols 
as operands in place of the expressions. 
Thus, in the statement FIELD is 

i-r- t---1 

JName | Operation|Operand | 

j-+-+-~H 

ill I 

j FIELD j EQU jALPHA-BETA+GAMMA | 

L_J._J-,-J 
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defined as ALPHA-BETA+GAMMA and may be used 
in place of it. Note, however, that ALPHA, 
BETA, and GAMMA must all be previously 
defined. If the final result of the 
expression is negative, the low order 24 
bits of the 2's complement is used. 


Data Definition Instructions 


There are three data definition instruction 
statements: Define Constant (DC) , Define 

Storage (DS), and Define Channel Command 
Word (CCW) . 

These statements are used to enter data 
constants into storage, to define and 
reserve areas of storage, and to specify 
the contents of channel command words. The 
statements may be named by symbols so that 
other program statements can refer to the 
fields generated from them. The discussion 
of the DC instruction is far more extensive 
than that of the DS instruction, because 
the DS instruction is written in the same 
format as the DC instruction and may 
specify some or all of the information that 
the DC instruction provides. Only the 
function and treatment of the statements 
vary. For this reason, the DC instruction 
is presented first and discussed in more 
detail than the DS instruction. 


DC—DEFINE CONSTANT 


The DC instruction is used to provide 
constant data in storage. It may specify 
one constant or a series of constants, 
thereby relieving the programmer of the 
necessity to write a separate data 
definition statement for each constant 
desired. Furthermore, a variety of 
constants may be specified: fixed-point, 
floating-point, decimal, hexadecimal, 
character, and storage addresses. (Data 
constants are generally called constants 
unless they are created from storage 
addresses, in which case they are called 
address constants.) The typical form of 
the DC instruction statement is as follows: 


|Name jOperation!Operand 


h- 

-f- 

-f- 

--1 

Any symbol 

1 DC 

|One operand (D as-| 

or not used 

1 

1 

1 

1 

1 

1 

j sembler) or one or j 
(more operands (F j 
jassembler) in the j 
jformat described | 

|below, each separ-j 
ated by a comma. 



__ 4 --- 



Each operand consists of four subfields; 
the first three describe the constant, and 
the fourth subfield provides the constant 
or constants. The first and third 
subfields may be omitted, but the second 
and fourth must be specified. Note that 
more than one constant may be specified in 
the fourth subfield for most types of 
constants. Each constant so specified must 
be of the same type; the descriptive 
subfields that precede the constants apply 
to all of them. No blanks may occur within 
any of the subfields (unless provided as 
characters in a character constant or a 
character self-defining term), nor may they 
occur between the subfields of an operand. 
Similarly, blanks may not occur between 
operands and the commas that separate them 
when multiple operands are being specified. 


The subfields of the DC operand are 
written in the following sequence: 

| Subfield | 

| 1 2 3 4 | 

|--j-- T - T - 

|Dupli- |Type {Modifiers |Constant (s) | 

|cation | ] | I 

|Factor | | | I 

L-1_I- ± _J 

The symbol that names the DC instruction 
is the name of the constant (or first 
constant if the instruction specifies more 
than one) . Relative addressing (e.g., 
SYMBOL+2) may be used to address the 
various constants if more than one has been 
specified, because the number of bytes 
allocated to each constant can be 
determined. 

The value attribute of the symbol naming 
the DC instruction is the address of the 
leftmost byte (after any necessary 
alignment) of the first, or only, constant. 
The length attribute depends on two things: 
the type of constant being defined and the 
presence of a length specification. 

Implied lengths are assumed for the various 
constant types in the absence of a length 
specification. If more than one constant 
is defined, the length attribute is the 
length in bytes (specified or implied) of 
the first constant. 

Boundary alignment also varies according 
to the type of constant being specified and 
the presence of a length specification. 

Some constant types are only aligned to a 
byte boundary, but the DS instruction can 
be used to force any type of word boundary 
alignment for them. This is explained 
under "DS—Define Storage." Other 
constants are aligned at various word 
boundaries (half, full, or double) in the 
absence of a length specification. If 
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length is specified, no boundary alignment 
occurs for such constants. 


Bytes that must be skipped in order to 
align the field at the proper boundary are 
not considered to be part of the constant. 
In other words, the location counter is 
incremented to reflect the proper boundary 
(if any incrementing is necessary) before 
the address value is established. Thus, 
the symbol naming the constant will not 
receive a value attribute that is the 
location of a skipped byte. 


Any bytes skipped in aligning statements 
that do not cause information to be 
assembled are not zeroed. Thus bytes 


r\n 4- - 






LCJ.UCU I 


and bytes skipped to align a DS statement 
are not zeroed. 


Note that a duplication factor of zero 
is permitted except in a literal and 
achieves the same result as it would in a 
DS instruction. A DC instruction with a 
zero duplication factor will not produce 
control dictionary entries. See "Forcing 
Alignment" under "DS—Define Storage." 

Note : If duplication is specified for an 

address constant containing a location 
counter reference, the value of the 
location counter used in each duplication 
is incremented by the length of the 
operand. 


Operand Subfield 2: Type 


Appendix F summarizes, in chart form, 
the information concerning constants that 
is presented in this section. 

LITERAL DEFINITIONS : The reader is 
reminded that the discussion of literals as 
machine instruction operands (in Section 2) 
referred him to the description of the DC 
operand for the method of writing a literal 
operand. All subsequent operand 
specifications are applicable to writing 
literals, the only differences being: 

1. The literal is preceded by an = sign. 

2. Unsigned decimal values must be used 
to express the duplication factor and 
length modifier values. 

3. The duplication factor may not be 
zero. 

4. s-type address constants may not be 
specified. 

5. Signed or unsigned decimal values must 
be used for exponent and scale 
modifier values. 

Examples of literals appear throughout 
the balance of the DC instruction 
discussion. 


Operand Subfield 1: Duplication Factor 


The duplication factor may be omitted. If 
specified, it causes the constant (s) to be 
generated the number of times indicated by 
the factor. The factor may be specified 
either by an unsigned decimal self-defining 
term or by a positive absolute expression 
that is enclosed by parentheses. The 
duplication factor is applied after the 
constant is assembled. All symbols in the 
expression must be previously defined. 


The type subfield defines the type of 
constant being specified. From the type 
specification, the assembler determines how 
it is to interpret the constant and 
translate it into the appropriate machine 
format. The type is specified by a single 
letter code as shown in Figure 8. 

Further information about these 
constants is provided in the discussion of 
the constants themselves under "Operand 
Subfield 4: Constant." 


Operand Subfield 3: Modifiers 


Modifiers describe the length in bytes 
desired for a constant (in contrast to an 
implied length) , and the scaling and 
exponent for the constant. If multiple 
modifiers are written, they must appear in 
this sequence: length, scale, exponent. 
Each is written and used as described in 
the following text. 


LENGTH MODIFIER : This is written as Ln, 
where n is either an unsigned decimal 
self-defining term or a positive absolute 
expression enclosed by parentheses. Any 
symbols in the expression must be 
previously defined. The value of n 
represents the number of bytes of storage 
that are assembled for the constant. The 
maximum value permitted for the length 
modifiers supplied for the various types of 
constants is summarized in Appendix F. 

This table also indicates the implied 
length for each type of constant; the 
implied length is used unless a length 
modifier is present. A length modifier may 
be specified for any type of constant. 
However, no boundary alignment will be 
provided when a length modifier is given. 
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j Code 


of Constant 


Machine Format 


jc Character 8-bit code for each character 

jx Hexadecimal 4-bit code for each hexadecimal digit 

j B Binary Binary format 

|F Fixed-point Signed, fixed-point binary format; normally a fullword 

|H Fixed-point Signed, fixed-point binary format; normally a halfword 

(E Floating-point Short floating-point format; normally a fullword 

|D Floating-point Long floating-point format; normally a doubleword 

|L Floating-point Extended floating-point format; normally two double words 

| (DOS Assembler D 14K variant only) 

jp Decimal Packed decimal format 

j z Decimal Zoned decimal format 

jA Address Value of address; normally a fullword 

|Y Address Value of address; normally a halfword 

js Address Base register and displacement value; a halfword 

jv Address Space reserved for external symbol addresses; each address 

| normally a fullword 


Figure 8. Type Codes for Constants 


Bit-Length Specification (F assembler In storage: 

only) : The length of a constant, in bits, 

is specified by L.n, where n is specified byte byte byte 
as stated above and represents the number 1 h I J 

of bits in storage into which the constant j^paddingj j 

is to be assembled. The value of n may |00010010(00011000 j 

exceed eight and is interpreted to mean an ' ' 

integral number of bytes plus so many bits. 579 fill 

For example, L.20 is interpreted as a 

length of two bytes plus four bits. Figure 9. Bit-Length Specification (Single 

Constant) 


Assembly of the first or only constant 
with bit-length specification starts on a 
byte boundary. The constant is placed in 
the high- or low-order end of the field 
depending on the type of constant being 
specified. The constant is padded or 
truncated to fit the field. If the 
assembled length does not leave the 
location counter set at a byte boundary, 
and another bit length constant does not 
immediately follow in the same statement, 
the remainder of the last byte used is 
filled with zeros. This leaves the 
location counter set at the next byte 
boundary. Figure 9 shows a fixed-point 
constant with a specified bit-length of 13, 
as coded, and as it would appear in 
storage. Note that the constant has been 
padded on the left to bring it to its 
designated 13-bit length. 


As coded: 


The implied length of BLCON is two 
bytes. A reference to EICON would cause 
the entire two bytes to be referenced. 


When bit-length specification is used in 
association with multiple constants (see 
■Operand Subfield 4: Constant" following), 
each succeeding constant in the list is 
assembled starting at the next available 
bit. Figure 10 illustrates this. 


As coded: 


i-f- T - 

|Name (Operation|Operand 

I-4-4--— 

j BLMCON j DC |F1.10*161,21,57* 


r —-- r -r- 

|Name |OperationlOperand 

I--1- f - 

j BLCON (DC |FL.13*579 

u-j.- j. _ 


I 

I 


Section 5: Assembler Instruction Statements 49 










In storage: 


byte byte byte byte byte 

III!! 

| | padding) padding | 

I I - I -1 I 

1 00101000)01000001101010000)11100tooJ 

161 21 57 fill 

Figure 10. Bit-Length Specification 
(Multiple Constants) 


The symbol used as a name entry in a DC 
assembler instruction takes on the length 
attribute of the first constant in the 
list; therefore the implied length of 
BLMCON in Figure 10 is two bytes. 


If duplication is specified, filling 
occurs once at the end of the field 
occupied by the duplicated constant(s) . 


When bit-length specification is used in 
association with multiple operands, 
assembly of the constant(s) in each 
succeeding operand starts at the next 
available bit. Figure 11 illustrates this. 

As coded: 


) |Oper-|Operand 

jName Jation| 

J BLMOCONIDC |FL.7'9' 


L-A-J. 


,CL.10'AB * 


1 


- 

, XL.14'C4' j 

-j 


In storage: 

byte byte byte byte byte 

I I I I I 

|padding | |padding ) j 

1 ^ I I._J ! 

1 000100111 1000001, 11 1 00000011 10001 000^ J 
9 | A I C4 Cfill 


A plus 
first two 
bits of B 


SCALE MODIFIER : This modifier is written 
as Sn, where n is either a decimal value or 
an absolute expression enclosed by 
parentheses. Any symbol in the expression 
must be previously defined. The decimal 
value or the parenthesized expression may 
be preceded by a sign; if none is present, 
a plus sign is assumed. The maximum values 
for scale modifiers are summarized in 
Appendix F. 

A scale modifier may be used with 
fixed-point (F, H) and floating-point (E, 

D, and L) constants only. It is used to 
specify the amount of internal scaling that 
is desired, as follows. 




XT 


vao cau co • 


The scale modifier specifies the power of 
two by which the constant must be 
multiplied after it has been converted to 
its binary representation. Just as 
multiplication of a decimal number by a 
power of 10 causes the decimal point to 
move, multiplication of a binary number by 
a power of two causes the binary point to 
move. This multiplication has the effect 
of moving the binary point away from its 
assumed position in the binary field; the 
assumed position being to the right of the 
rightmost position. 


Thus, the scale modifier indicates 
either of the following: (1) the number of 
binary positions to be occupied by the 
fractional portion of the binary number, or 
(2) the number of binary positions to be 
deleted from the integral portion of the 
binary number. A positive scale of x 
shifts the integral portion of the number x 
binary positions to the left, thereby 
reserving the rightmost x binary positions 
for the fractional portion. A negative 
scale shifts the integral portion of the 
number right, thereby deleting rightmost 
integral positions. If a scale modifier 
does not accompany a fixed-point constant 
containing a fractional part, the 
fractional part is lost . 

In all cases where positions are lost 
because of scaling (or the lack of 
scaling) , rounding occurs in the leftmost 
bit of the lost portion. The rounding is 
reflected in the rightmost position saved. 


Figure 11. Bit-Length Specification 
(Multiple Operands) 


In Figure 11, three different types of 
constants have been specified, one to an 
operand. Note that the character constant 
'AB' which normally would occupy 16 bits is 
truncated on the right to fit the 10-bit 
field designated. Note that filling occurs 
only at the end of the field occupied by 
all the constants. 


Scale Modifier for Floating-Point 
Constants . Only a positive scale modifier 
may be used with a floating-point constant. 
It indicates the number of hexadecimal 
positions that the fraction is to be 
shifted to the right. Note that this shift 
amount is in terms of hexadecimal 
positions, each of which is four binary 
positions. (A positive scaling actually 
indicates that the point is to be moved to 
the left. However, a floating-point 
constant is always converted to a 
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fraction,which is hexadecimally normalized. 
The point is assumed to be at the left of 
the leftmost position in the field. Since 
the point cannot be moved left, the 
fraction is shifted right.) 

Thus, scaling that is specified for a 
floating-point constant provides an 
assembled fraction that is unnormalized, 
i.e., contains hexadecimal zeros in the 
leftmost positions of the fraction. When 
the fraction is shifted, the exponent is 
adjusted accordingly to retain the correct 
magnitude. When hexadecimal positions are 
lost, rounding occurs in the leftmost 
hexadecimal position of the lost portion. 
The rounding is reflected in the rightmost 
hexadecimal position saved. 

EXPONENT MODIFIER : This modifier is 
written as En, where n is either a decimal 
self-defining term or an absolute 
expression enclosed by parentheses. Any 
symbols in the expression must be 
previously defined. The decimal value or 
the parenthesized expression may be 
preceded by a sign; if none is present, a 
plus sign is assumed. The maximum values 
for exponent modifiers are summarized in 
Appendix F. 

An exponent modifier may be used with 
fixed-point (F, H) and floating-point (E, 

D, and L) constants only. The modifier 
denotes the power of 10 by which the 
constant is to be multiplied before its 
conversion to the proper internal format. 

This modifier is not to be confused with 
the exponent of the constant itself, which 
is specified as part of the constant and is 
explained under "Operand Subfield 4: 
Constant." Both are denoted in the same 
fashion, as En. The exponent modifier 
affects each constant in the operand, 
whereas the exponent written as part of the 
constant only pertains to that constant. 
Thus, a constant may be specified with an 
exponent of +2, and an exponent modifier of 
+5 may precede the constant. In effect, 
the constant has an exponent of +7. 

Note that there is a maximum value, both 
positive and negative, listed in Appendix F 
for exponents. This applies to the 
exponent modifier and to the sum of the 
exponent modifier and the exponent 
specified as part of the constant. 


Operand Subfield 4; Constant 


This subfield supplies the constant (or 
constants) described by the subfields that 
precede it. A data constant (all types 
except A, Y, S, and V) is enclosed by 


apostrophes. An address constant (types A, 
Y, S, and V) is enclosed by parentheses. 

To specify two or more constants in the 
subfield, the constants must be separated 
by commas and the entire sequence of 
constants must be enclosed by the 
appropriate delimiters (i.e., apostrophes 
or parentheses) . Thus, the format for 
specifying the constant (s) is one of the 
following: 


r- t-t 

| Single j Multiple j 

(Constant | Constants* | 

V - + - j 

I I I 


|'constant* | 'constant,...,constant* 
j (constant) j (constant,...,constant) 



|’Not permitted for character, j 

j hexadecimal, and binary constants. j 

L-J 


All constant types except character (C), 
hexadecimal (X) , binary (B), packed decimal 
(P), and zoned decimal (Z), are aligned on 
the proper boundary, as shown in Appendix 
F, unless a length modifier is specified. 

In the presence of a length modifier, no 
boundary alignment is performed. If the 
operand specifies more than one constant, 
any necessary alignment applies to the 
first constant only. Thus, for an operand 
that provides five fullword constants, the 
first would be aligned on a fullword 
boundary, and the rest would automatically 
fall on fullword boundaries. 

The total storage requirement of the 
operand is the product of the length times 
the number of constants in the operand 
times the duplication factor (if present) 
plus any bytes skipped for boundary 
alignment. 

If an address constant contains a 
location counter reference, the location 
counter value that is used is the storage 
address of the first byte the constant will 
occupy. Thus, if several address constants 
in the same instruction refer to the 
location counter , the value of the 
location counter varies from constant to 
constant. Similarly, if a single constant 
is specified (and it is a location counter 
reference) with a duplication factor, the 
constant is duplicated with a varying 
location counter value. 

E and H constants are converted as if 
they were D and F, respectively, and then 
shortened. 

The subsequent text describes each of 
the constant types and provides examples. 


Section 5: Assembler Instruction Statements 51 








Character Constant—C . Any of the valid 
256 punch combinations may be designated in 
a character constant. Only one character 
constant may be specified per operand. 

Special consideration must be given to 
representing apostrophes and ampersands as 
characters. Each apostrophe or ampersand 
desired as a character in the constant must 
be represented by a pair of apostrophes or 
ampersands. Only one apostrophe or 
ampersand appears in storage. 

The maximum length of a character 
constant is 256 bytes. No boundary 
alignment is performed. Each character is 
translated into one byte. Double 
apostrophes or double ampersands count as 
one character. If no length modifier is 
given, the size in bytes of the character 
constant is equal to the number of 
characters in the constant. If a length 
modifier is provided, the result varies as 
follows: 

1. If the number of characters in the 
constant exceeds the specified length, 
as many rightmost bytes as necessary 
are dropped. 

2. If the number of characters is less 
than the specified length; the excess 
rightmost bytes are filled with 
blanks. 

In the following example, the length 
attribute of FIELD is 12: 


r- t-t- 

(Name |Operation|Operand 


|FIELD |DC 
L_X_ 


|C'TOTAL IS 110* 
.X- 


However, in this next example, the 
length attribute is 15, and three blanks 
appear in storage to the right of the zero: 


jName jOperation!Operand 1 

f--+-+-i 

j FIELD |DC |CL15 * TOTAL IS 110* 

l--J.-X ,.-J 

In the next example, the length 

attribute of FIELD is 12, although 13 
characters appear in the operand. The two 
ampersands count as only one byte. 


(Name jOperation|Operand 

F-+-+- 

j FIELD j DC |C 1 TOTAL IS 6610* 


Note that in the next example, a length 
of four has been specified, but there are 
five characters in the constant. 


r-T- t- 

JName |Operation!Operand 

}■- + --j.- 

|FIELD |DC j 3CL4*ABCDE* 

l -x-x_ 


The generated constant would be: 

ABCDABCDABCD 

On the other hand, if the length had 
been specified as six instead of four, the 
generated constant would have been: 

ABODE ABCEE AECDE 

Note that the same constant could be 
specified as a literal. 


|Name {OperationjOperand j 

t -+-+-1 

j |MVC jAREA (12) ,=3CL4'ABCDE* j 

L-X-X-J 


Hexadecimal Constant—X . A hexadecimal 
constant consists of one or more of the 
hexadecimal digits, which are 0-9 and A-F. 
Only one hexadecimal constant may be 
specified per operand. The maximum length 
of a hexadecimal constant is 256 bytes (512 
hexadecimal digits). No word boundary 
alignment is performed. 

Constants that contain an even number of 
hexadecimal digits are translated as one 
byte per pair of digits. If an odd number 
of digits is specified, the leftmost byte 
has the leftmost four bits filled with a 
hexadecimal zero, while the rightmost four 
bits contain the odd (first) digit. 

If no length modifier is given, the 
implied length of the constant is half the 
number of hexadecimal digits in the 
constant (assuming that a hexadecimal zero 
is added to an odd number of digits). If a 
length modifier is given, the constant is 
handled as follows: 

1. If the number of hexadecimal digit 
pairs exceeds the specified length, 
the necessary leftmost bits (and/or 
bytes) are dropped. 

2. If the number of hexadecimal digit 
pairs is less than the specified 
length, the necessary bits (and/or 
bytes) are added to the left and 
filled with hexadecimal zeros. 

An eight-digit hexadecimal constant 
provides a convenient way to set the bit 
patter^ of a full binary word. The 
constant is the following example would set 
the first and third bytes of a word to 1*s. 
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r - T - T -1 

| Name |Operation!Operand | 

I--+-+--i 

I IDS I OF I 

I TEST J DC |X* FF00FF00' | 

L-X-X-J 


The DS instruction sets the location 
counter to a fullword boundary. 

The next example uses a hexadecimal 
constant as a literal and inserts Is into 
bits 24 through 31 of register 5. 

r- t -t-1 

|Name |Operation!Operand J 

I--+-+- ^ 

j jlC |5,=X'FF' INSERT CHAR. j 

i-x-x_J 

In the following example, the digit A 
would be dropped, because five hexadecimal 
digits are specified for a length of two 
bytes: 

r-T-T-T 

|Name |Operation!Operand J 

I--+-f-^ 

J ALPHACON|DC |3XL2'A6F4E' \ 

L-X-X-J 

The resulting constant would be 6F4E, 
which would occupy the specified two bytes. 
It would then be duplicated three times, as 
requested by the duplication factor. If it 
had merely been specified as X'A6F4E', the 
resulting constant would have had a 
hexadecimal zero in the leftmost position: 

0A6F4E 


Binary Constant—B . A binary constant is 
written using 1*s and O's enclosed in 
apostrophes. Only one binary constant may 
be specified per operand. Duplication and 
length may be specified. The maximum 
length of a binary constant is 256 bytes. 

The implied length of a binary constant 
is the number of bytes occupied by the 
constant including any padding necessary. 
Padding or truncation takes place on the 
left. The padding bit used is a 0. 

The following example shows the coding 
used to designate a binary constant. BCON 
would have a length attribute of one. 


r 

(Name 

j. 

jOperation J Operand 
j. 

j BCON 

1 DC 

|B'11011101* 

|BTRUNC 

j DC 

|BL1'100100011* 

1 BPAD 

j DC 

|BL1 * 101' 

L 

.X__ 



BTRUNC would assemble with the leftmost 
bit truncated, as follows: 

00100011 


BPAD would assemble with five zeros as 
padding, as follows: 

00000101 


Fixed-Point Constants—F and H . A 
fixed-point constant is written as a 
decimal number, which may be followed by a 
decimal exponent if desired. The number 
may be an integer, a fraction, or a mixed 
number (i.e., one with integral and 
fractional portions) . The format of the 
constant is as follows: 

1. The number is written as a signed or 
unsigned decimal value. The decimal 
point may be placed before, within, or 
after the number, or it may be 
omitted, in which case the number is 
assumed to be an integer. A positive 
sign is assumed if an unsigned number 
is specified. Unless a scale modifier 
accompanies a mixed number or 
fraction, the fractional portion is 
lost, as explained under "Subfield 3: 
Modifiers." 

2. The exponent is optional. If 
specified, it is written immediately 
after the number as En, where n is an 
optionally signed decimal value 
specifying the exponent of the factor 
10. The exponent may be in the range 
-85 to +75. If an unsigned exponent 
is specified, a plus sign is assumed. 
The exponent causes the value of the 
constant to be adjusted by the power 
of 10 that it specifies. The exponent 
may exceed the permissible range for 
exponents provided that the sum of the 
exponent and the exponent modifier do 
not exceed that range. 

The number is converted to a binary 
number. The binary number is then rounded 
and assembled into the proper field, 
according to the specified or implied 
length. If the value of the number exceeds 
the length specified or implied, the sign 
is lost, the necessary leftmost bits are 
truncated to the length of the field and 
the value is then assembled into the whole 
field. Any duplication factor that is 
present is applied after the constant is 
assembled. A negative number is carried in 
2's complement form. The resulting number 
will not differ from the exact value by 
more than one in the last place. 

An implied length of four bytes is 
assumed for a fullword (F) and two bytes 
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for a halfword (H) , and the constant is 
aligned to the proper fullword or halfword 
boundary, if a length is not specified. 
However, any length up to and including 
eight bytes may be specified for either 
type of constant by a length modifier, in 
which case no boundary alignment occurs. 

Maximum and minimum values, exclusive of 
scaling, for fixed-point constants are: 


Lenqth 

Max 

Min 

8 

263—1 

-2 63 

4 

2 3 *-1 

-2 31 

2 

2*5-1 

-2*5 

1 

2 7 -1 

-27 

.4 

2 3 -1 

-2 3 

.2 

2*-1 

-2* 

.1 

0 

-1 


A field of three fullwords is generated 
from the statement shown below. The 
location attribute of CONWRD is the address 
of the leftmost byte of the first word, and 
the length attribute is four, the implied 
length for a fullword fixed-point constant. 
The expression CONWRE+4 could be used to 
address the second constant (second word) 
in the field. 


|Name jOperationjOperand j 

I-- + -+--I 

(CONWRD jDC j 3F'658474 1 j 

L- X _ X -J 

The next statement causes the generation 
of a two-byte field containing a negative 
constant. Notice that scaling has been 
"specified in order to reserve six bits for 
the fractional portion of the constant. 

r- t -r-1 

|Name |Operation!Operand I 

\ -+-+--I 

|HALFCON|DC |HS6'-25.46' j 

L-i- X _J 

The next constant (3.50) is multiplied 
by 10 to the -2 before being converted to 
its binary format. The scale modifier 
reserves twelve bits for the fractional 
portion. 


The final example specifies three 
constants. Notice that the scale modifier 
requests four bits for the fractional 
portion of each constant. The four bits 
are provided whether or not the fraction 
exists. 


r- t-t- 

| Name |Operation|0 perand 

j.-1-1- 

(THREECON j DC (FS4*10,25.3,100' 

L- X - X _ 


1 

I 

-I 

i 

.j 


Floating-Point Constants—E, D, and L . A 
floating-point constant is written as a 
decimal number, which may be followed by a 
decimal exponent, if desired. The number 
may be an integer, a fraction, or a mixed 
number (i.e., one with integral and 
fractional portions) . The format of the 
constant is as follows: 

1. The number is written as a signed or 
unsigned decimal value. The decimal 
point may be placed before, within, or 
after the number, or it may be 
omitted, in which case, the number is 
assumed to be an integer. A positive 
sign is assumed if an unsigned number 
is specified. 

2. The exponent is optional. If 
specified, it is written immediately 
after the number as En, where n is an 
optionally signed decimal value 
specifying the exponent of the factor 
10. The exponent may be in the range 
-85 to +78. The exponent may exceed 
the permissible range for exponents, 
provided that the sum of the exponent 
and the exponent modifier does not 
exceed that range. If an unsigned 
exponent is specified, a plus sign is 
assumed. 

Machine format for a floating-point 
number is in two parts: the portion 
containing the exponent, which is sometimes 
called the characteristic, followed by the 
portion containing the fraction, which is 
sometimes called the mantissa. Figure 12 
shows the external format of the three 
types of floating-point constants. 


r -T-t- 

|Name (Operation(Operand 

f - + -+- 

j FULLCON|DC jHS 12 * 3.50E-2' 

L-J._ X - 

The same constant could be specified as 
a literal: 

r- t-t- 

(Name |Operation|Operand | 

(■-+-+--I 

( (AH j 7,=HS12* 3.50E-2' j 

L-JL- X -J 


1 As shown in the figure, the format of 

j the type L constant is similar to that of 

-j two contiguous type E constants, except 

j that it is assembled with the sign of the 
second double word equal to that of the 
first, and the characteristic of the second 
equal to that of the first minus 14, module 
128. The type L constant has been 
implemented to provide the programmer with 
extended precision floating-point 
constants. 

Since the machine format of a floating¬ 
point constant only consists of a fraction 
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SHORT FLOATING POINT NUMBER (E) 

f-T-1-1 

| | 7 BIT | I 

j S I CHARAC- | | 

l j TERISTIC | j 

L_ L - L -J 

0 7 8 31 

LONG FLOATING POINT NUMBER (D) 

r - r -T-T 

| | 7 BIT | | 

j S | CHARAC- | 56-BIT FRACTION | 

j j TERISTIC | | 

L-i- L -J 

0 7 8 63 

EXTENDED FLOATING POINT NUMBER (L) 

r -^-,- 1 

| | 7 BIT | HIGH ORDER HALF OF | 

j S j CHARAC- j 112 BIT FRACTION j 

j | TERISTIC j j 

L_L-i.-J 

0 7 8 63 

r - r -1 

| | LOW ORDER HALF OF | 

j j 112 BIT FRACTION j 

l-JL-J 

0 7 8 63 

Figure 12. Floating-Point External Formats 


and an exponent, the number specified as a 
floating-point constant must be converted 
to a fraction before it can be translated 
into the proper format. For example, the 
constant 27.35E2 represents the number 
27.35 times 10 to the 2nd. Represented as 
a fraction, it would be .2735 times 10 to 
the 4th, the exponent having been modified 
to reflect the shifting of the decimal 
point. The exponent may also be affected 
by the presence of an exponent modifier, as 
explained under "Operand Subfield 3: 
Modifiers." 

The exponent is then translated into its 
binary equivalent, and the fraction is 
converted to a binary number. Scaling is 
performed if specified; if not, the 
fraction is normalized (leading hexadecimal 
zeros are removed). Rounding of the 
fraction is then performed according to the 
specified or implied length, and the number 
is assembled into the proper field. Within 
the portion of the floating-point field 
allocated to the fraction, the hexadecimal 
point is assumed to be to the left of the 
leftmost hexadecimal digit, and the 
fraction occupies the leftmost portion of 
the field. Negative fractions are carried 
in true representation, not in the 2's 
complement form. The resulting number will 
not differ from the exact value by more 
than one in the last place. An implied 
length of four bytes is assumed for a short 


(E) constant and eight bytes for a long (D) 
constant. An implied length of 16 bytes is 
assumed for an extended (L) constant. The 
constant is aligned at the proper word (E) 
or double word (D and L) boundary if a 
length is not specified. However, any 
length up to and including eight bytes (E 
and D) or 16 bytes (L) can be specified by 
a length modifier. In this case, no 
boundary alignment occurs. 


Any of the following statements could be 
used to specify 46.415 as a positive, 
fullword, floating-point constant; the last 
is a machine instruction statement with a 
literal operand. Note that the last two 
constants contain an exponent modifier. 


r — 

|Name 

t 

|Operation|Operand 

A A _ 


T 

T 


j DC 

|E*46.415* 


j DC 

|E* 46415E-3 * 


j DC 

j E" +464.15E-1' 


j DC 

|E'+.46415E+2* 


j DC 

|EE2*.46415* 

L 

j AE 

1 6,=EE2 *.46415' 


The following would each be generated as 
doubleword floating-point constants. 
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r- 

| Name 

f- 

| FLOAT 
l- 


j Operation]Operand 

+-f- 

j DC j DE +4*+46,-3. 729,+473* 

J.- L - 


1 

I 

I 

J 


Decimal Constants—P and Z . A decimal 
constant is written as a signed or unsigned 
decimal value. If the sign is omitted, a 
plus sign is assumed. The decimal point 
may be written wherever desired or may be 
omitted. Scaling and exponent modifiers 
may not be specified for decimal constants. 
The maximum length of a decimal constant is 
16 bytes. No word boundary alignment is 
performed. 


1. If the constant requires fewer bytes 
than the length specifies, the 
necessary number of bytes is added to 
the left. For zoned decimal format, 
the decimal digit zero is placed in 
each added byte. For packed decimals, 
the bits of each added byte are set to 
ze ro. 

2. If the constant requires more bytes 
than the length specifies, the 
necessary number of leftmost digits or 
pairs of digits is dropped, depending 
on which format is specified. 

Examples of decimal constant definitions 
follow. 


The placement of a decimal point in the 
definition does not affect the assembly of 
the constant in any way, because, unlike 
fixed-point and floating-point constants, a 
decimal constant is not converted to its 
binary equivalent. The fact that a decimal 
constant is an integer, a fraction, or a 
mixed number is not pertinent to its 
generation. Furthermore, the decimal point 
is not assembled into the constant. The 
programmer may determine proper decimal 
point alignment either by defining his data 
so that the point is aligned or by 
selecting machine instructions that will 
operate on the data properly (i.e., shift 
it for purposes of alignment). 

If zoned decimal format is specified 
(Z) , each decimal digit is translated into 
one byte. The translation is done 
according to the character set shown in 
Appendix A. The rightmost byte contains 
the sign as well as the rightmost digit. 

For packed decimal format (P), each pair of 
decimal digits is translated into one byte. 
The rightmost digit and the sign are 
translated into the rightmost byte. The 
bit configuration for the digits is 
identical to the configurations for the 
hexadecimal digits 0-9 as shown in Section 
3 under "Hexadecimal Self-Defining Value." 
For both packed and zoned decimals, a plus 
sign is translated into the hexadecimal 
digit C, and a minus sign into the digit D. 

If an even number of packed decimal 
digits is specified, one digit will be left 
unpaired, because the rightmost digit is 
paired with the sign. Therefore, in the 
leftmost byte, the leftmost four bits will 
be set to zeros and the rightmost four bits 
will contain the odd (first) digit. 

If no length modifier is given, the 
implied length for either constant is the 
number of bytes the constant occupies 
(taking into account the format, sign, and 
possible addition of zero bits for packed 
decimals). if a length modifier is given, 
the constant is handled as follows: 


|Name 

j.- 

I 


T-T- 

|Operation|Operand 

"f-(■- 

j DC jp'+I^S* 

|DC |Z*-543* 

|DC JZ'79.68' 

j DC | PL3'79 .68 


i 

I 

H 


I 


The following statement specifies three 
packed decimal constants. The length 
modifier applies to each packed decimal 
constant. 


i-r- t-1 

{Name |Operation]Operand j 

j--j-4-1 

j DECIMALS j DC |PL8*+25.8,-3874,+2.3* | 


The last example illustrates the use of 
a packed decimal literal. 

r-7- t- - - 1 

{Name {OperationjOperand | 

I-4-4-1 

j JUNPK |0UTAREA,=PL2 , +25* j 

I_-L_l-1 

ADDRESS CONSTANTS : An address constant is 
a storage address that is translated into a 
constant. Address constants can be used 
for initializing base registers to 
facilitate the addressing of storage. 
Furthermore, they provide the means of 
communicating between control sections of a 
multisection program. However, storage 
addressing and control section 
communication are also dependent on the use 
of the USING assembler instruction and the 
loading of registers. Coding examples that 
illustrate these considerations are 
provided in Section 3 under "Programming 
with the Using Instruction." 

An address constant, unlike other types 
of constants, is enclosed in parentheses. 

If two or more address constants are 
specified in a statement, they are 
separated by commas, and the entire 
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sequence is enclosed by parentheses. There 
are four types of address constants: A, Y, 
S, and V. 


Complex Relocatable Expressions . A complex 
relocatable expression can only be used in 
an A-type or Y-type address constant. 

These expressions contain two or more 
unpaired relocatable terms and/or a 
negative relocatable term in addition to 
any absolute or paired relocatable terms 
that may be present. In contrast to 
relocatable expressions, complex 
relocatable expressions may represent 
negative values. A complex relocatable 
expression might consist of external 
symbols (which cannot be paired) and 
designate an address in an independent 
assembly that is to be linked and loaded 
with the assembly containing the address 
constant. 


The value of the expression is 
determined when the referenced control 
sections are loaded. Complex relocatable 
expressions can be used to determine the 
distance between two control sections after 
they are loaded into main storage. 


A-Type Address Constant . This constant is 
specified as an absolute, relocatable, or 
complex relocatable expression. (Remember 
that an expression may be single term or 
multiterm.) The value of the expression is 
calculated to 32 bits as explained in 
Section 2, with one exception: the maximum 
value of the expression may be 2 3 ■* — 1. The 
value is then truncated on the left, if 
necessary, to the specified or implied 
length of the field and assembled into the 
rightmost bits of the field. The implied 
length of an A-type constant is four bytes 
and alignment is to a fullword boundary 
unless a length is specified, in which case 
no ^alignment will occur. The length that 
may be specified depends on the type of 
expression used for the constant; a length 
of 1-4 bytes (.1 (1 bit) to 4 bytes for DOS 

F) may be used for an absolute expressions, 
while a length of 3 or 4 bytes may be used 
for a relocatable or complex relocatable 
expression. 

In the following examples, the field 
generated from the statement named ACON 
contains four constants, each of which 
occupies four bytes. Note that there is a 
location counter reference in one. The 
value of the location counter will be the 
address of the first byte allocated to the 
fourth constant. The second statement 
shows the same set of constants specified 
as literals (i.e., address constant 
literals) . 


I-T-T 

I |Oper-1 
[Name|ation|Operand j 

|-4-+-1 

}ACON|DC |A (108,LOP,END-STRT,* + 4096) | 

l |LM |4,7,=A (108,LOP,END-STRT,* + 4096) j 

i_L_J._J 


Note : When the location counter reference 
occurs in a literal, as in the LM 
instruction above, the value of the 
location counter is the address of the 
first byte of the instruction. 

Y-type Address Constant . A Y-type address 
constant has much in common with the A-type 
constant. It, too, is specified as an 
absolute, relocatable, or complex 
relocatable expression. The value of the 
expression is also calculated to 32 bits as 
explained in Section 2. However, the 
maximum value of the expression may be only 
2**-1. The value is then truncated, if 
necessary, to the specified or implied 
length of the field and assembled into the 
rightmost bits of the field. The implied 
length of a Y-type constant is two bytes 
and alignment is to a halfword boundary 
unless a length is specified, in which case 
no alignment occurs. The maximum length of 
a Y-type address constant is two bytes. If 
length specification is used, a length of 
two bytes may be designated for a 
relocatable or complex expression and 1 or 
2 bytes (. 1 (1 bit) to 2 bytes for DOS F) 
for an absolute expression. 

Caution : Specification of relocatable 

Y-type address constants should be avoided 
in programs destined to be executed on 
machines having more than 32,767 bytes of 
storage capacity. 

S-Type Address Constant . The S-type 
address constant is used to store an 
address in base displacement form. 

The constant may be specified in two 
ways: 

1. As an absolute or relocatable 
expression, e.g., S (BETA). 

2. As two absolute expressions, the first 
of which represents the displacement 
value and the second, the base 
register, e.g., S (400 (13)). 

The address value represented by the 
expression in (1) will be broken down by 
the assembler into the proper base register 
and displacement value. An S-type constant 
is assembled as a halfword and aligned on a 
halfword boundary. The leftmost four bits 
of the assembled constant represents the 
base register designation; the remaining 12 
bits, the displacement value. 
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If length specification is used, only 
two bytes may be specified. S-type address 
constants may not be specified as literals. 


V-Type Address Constant . This constant is 
used to reserve storage for the address of 
an external symbol that is used for 
effecting branches to other programs. To 
maintain compatibility with the OS 
assemblers, the constant should not be used 
for external data reference. The constant 
is specified as one relocatable symbol, 
which need not be identified by an EXTRN 
statement. Whatever symbol is used is 
assumed to be an external symbol by virtue 
of the fact that it is supplied in a V-type 
address constant. To suppress the AUTOLINK 
function of the linkage editor for a 
constant identified in a V-type address 
constant, the programmer can identify it in 
a WXTRN statement (DOS Assembler 14K D 
only) . 

Note that specifying a symbol as the 
operand of a V-type constant does not 
constitute a definition of the symbol for 
this assembly. The implied length of a 
V-type address constant is four bytes, and 
boundary alignment is to a fullword. A 
length modifier may be used to specify a 
length of either three or four bytes, in 
which case no such boundary alignment 
occurs. In the following example, 12 bytes 
will be reserved, because there are three 
symbols. The value of each assembled 
constant will be zero until the program is 
loaded. 

r- t-t-1 

| Name |Operation!Operand f 

F- + - + - 

|VCONST 1DC jV (SORT,MERGE,CALC) j 

l-J.-X-J 


PS—DEFINE STORAGE 


exactly the same subfields are employed and 
are written in exactly the same sequence as 
they are in the DC operand. Although the 
formats are identical, there are two 
differences in the specification of 
subfields. They are: 

1. The specification of data (subfield 4) 
is optional in a DS operand, but it is 
mandatory in a DC operand. If a 
constant is specified, it must be 
valid. 

2. The maximum length that may be 
specified for character (C) and 
hexadecimal (X) field types is 65,535 
bytes rather than 256 bytes. 

If a DS operand specifies a constant in 
subfield 4, and no length is specified in 
subfield 3, the assembler determines the 
length of the data and reserves the 
appropriate amount of storage. It does not 
assemble the constant . The ability to 
specify data and have the assembler 
calculate the storage area that would be 
required for such data is a convenience to 
the programmer. If he knows the general 
format of the data that will be placed in 
the storage area during program execution, 
all he needs to do is show it as the fourth 
subfield in a DS operand. The assembler 
then determines the correct amount of 
storage to be reserved, thus relieving the 
programmer of length considerations. 

If the DS instruction is named by a 
symbol, its value attribute is the location 
of the leftmost byte of the reserved area. 
The length attribute of the symbol is 
determined in the same manner as for a EC. 
Any positioning required for aligning the 
storage area to the proper type of boundary 
is done before the address value is 
determined. Bytes skipped for alignment 
are not set to zero. 


The DS instruction is used to reserve areas 
of storage and to assign names to those 
areas. The use of this instruction is the 
preferred way of symbolically defining 
storage for work areas, input/output areas, 
etc. The typical form of the DS statement 
is: 


r i 

|Name 

i 

r -t- - 

Operation|Operand 

L X 

r . 

1 Any 
| symbol 
jdr not 
j used 

1 

1 

r 

DS 

T 

|One operand (D assem¬ 
bler) or one or more 
j operands (F assembler) 
jin the format de- 
j scribed below, each 
|separated by a comma. 


L---X-X-J 


The format of the DS operand is 
identical to that of the EC operand; 


Each field type (e.g., hexadecimal, 
character, floating-point) is associated 
with certain characteristics (these are 
summarized in Appendix F). The associated 
characteristics will determine which 
field-type code the programmer selects for 
the DS operand and what other information 
he adds, notably a length specification cr 
a duplication factor. For example, the E 
floating-point field and the F fixed-point 
field both have an implied length of four 
bytes. The leftmost byte is aligned to a 
fullword boundary. Thus, either code could 
be specified if it were desired to reserve 
four bytes of storage aligned to a fullword 
boundary. To obtain a length of eight 
bytes, one could specify either the E or F 
field type with a length modifier of eight. 
However, a duplication factor would have to 
be used to reserve a larger area, because 
the maximum length specification for either 
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type is eight bytes. Note also that Special Uses of the Duplication Factor 

specifying length would cancel any special 
boundary alignment. 


In contrast, packed and zoned decimal (P 
and Z) , character (C) , hexadecimal (X) , and 
binary (B) fields have an implied length of 
one byte. Any of these codes, if used, 
would have to be accompanied by a length 
modifier, unless just one byte is to be 
reserved. Although no alignment occurs, 
the use of C and X field types permits 
greater latitude in length specifications, 
the maximum for either type being 65,535 
bytes. (Note that this differs from the 
maximum for these types in a DC 
instruction.) Unless a field of one byte 
is desired, either the length must be 
specified for the C, X, P, Z, or B field 
types, or else the data must be specified 
(as the fourth subfield), so that the 
assembler can calculate the length. 

To define four 10-byte fields and one 
100-byte field, the respective DS 
statements might be as follows: 


FORCING ALIGNMENT : The location counter 
can be forced to a doubleword, fullword, or 
halfword boundary by using the appropriate 
field type (e.g., D, F, or H) with a 
duplication factor of zero. This method 
may be used to obtain boundary alignment 
that otherwise would not be provided. For 
example, the following statements would set 
the location counter to the next doubleword 
boundary and then reserve storage space for 
a 128-byte field (whose leftmost byte would 
be on a doubleword boundary). 


i-r- t-1 

(Name (Operation(Operand | 

|-f-4-■! 

I IDS |0D | 

| AREA |DS j CL128 j 

I_L_J._J 


(Name jOperationjOperand 

Y -+-f- 

(FIELD (DS (4CL10 

(AREA JDS |CL 100 

i_r_ l - 


I 

A 


j 


Although FIELD might have been specified 
as one 40-byte field, the preceding 
definition has the advantage of providing 
FIELD with a length attribute of 10. This 
would be pertinent when using FIELD as a SS 
machine instruction operand. 

Additional examples of DS statements are 
shown below: 


DEFINING FIELDS OF AN AREA : A DS 
instruction with a duplication factor of 
zero can be used to assign a name, to an 
area of storage without actually reserving 
the area. Additional DS and/or EC 
instructions may then be used to reserve 
the area and assign names to fields within 
the area (and generate constants if DC is 
used) . 


For example, assume that 80-character 
records are to be read into an area for 
processing and that each record has the 
following format: 


r 

|Name 

i _ 

—r - ~ “T* 

|Operation! 

j.. 

Ope rand 

r — 

T 

T 


jONE 

|DS 

1 

CL80 (one 80-byte 


1 

1 

field, length 


1 

1 

attribute of 80) 

(TWO 

(DS 

1 

80C (80 one-byte 


! 

1 

fields, length 


1 

1 

attribute of one) 

| THREE 

|DS 

1 

6F (six fullwords. 


1 

1 

length attribute of 


1 

1 

four) 

| FOUR 

|DS 

1 

D (one doubleword. 


1 

1 

length attribute of 


1 

1 

eight) 

(FIVE 

|DS 

1 

4H (four halfwords. 


1 

1 

length attribute of 


1 

1 

two) 

L- . 

—J.— _ 

_J_ 



Note : A DS statement causes the storage 
area to be reserved but not set to zeros. 
No assumption should be made as to the 
contents of the reserved area. 


Positions 5-10 
Positions 11-30 
Positions 31-36 
Positions 47-54 
Positions 55-62 


Payroll Number 
Employee Name 
Date 

Gross Wages 
Withholding Tax 


The following example illustrates how ES 
instructions might be used to assign a name 
to the record area, then define the fields 
of the area and allocate the storage for 
them. Note that the first statement names 
the entire area by defining the symbol 
RDAREA; the statement gives REARIA a length 
attribute of 80 bytes, but does not reserve 
any storage. Similarly, the fifth 
statement names a 6-byte area by defining 
the symbol DATE; the three subsequent 
statements actually define the fields of 
DATE and allocate storage for them. The 
second, ninth, and last statements are used 
for spacing purposes and, therefore, are 
not named. 


Section 5: Assembler Instruction Statements 59 













j Name 

1 

j Operation 

i __. 

Operand 

1 

. _ i 

r _ 

T 



1 

| RDAREA 

|DS 


0CL8 0 



|DS 


CL 4 


| PAYNO 

|DS 


CL6 


j NAME 

j DS 


CL20 


| DATE 

|DS 


0CL6 


| DAY 

|DS 


CL2 


j MONTH 

j DS 


CL2 


1 YEAR 

IDS 


CL2 



'|DS 


CLIO 


| GROSS 

|DS 


CL8 


| FEDTAX 

|DS 


CL 8 


|DS 

1 


CL 18 


L 

-X 

_ 

L__ _ 

_J 


CCW—DEFINE CHANNEL COMMAND WORD 


r -r -t- 1 

jName |Operation|Operand | 


|CCW j 2,READAREA,X* 48',80 


Note that the form of the third operand 
sets bits 37-39 to zero, as required. The 
bit pattern of this operand is as follows: 


32-35 36-39 

0100 1000 


If there is a symbol in the name entry 
of the CCW instruction, it is assigned the 
address value of the leftmost byte of the 
channel command word. The length attribute 
of the symbol is eight. 


The CCW instruction provides a convenient 
way to define and generate an eight-byte 
channel command word aligned at a 
doubleword boundary. The internal machine 
format of a channel command word is shown 
in Figure 12. CCW will cause any bytes 
skipped to be zeroed. The typical form of 
the CCW instruction statement is: 

r-1-1-1 

|Name |Operationl Operand | 

^-t-f- 1 


1 Any 

j CCW 

j Four operands, j 

|symbol or| 

| separated by commas,| 

|not used 

1 

1 

1 

1 

1 

1 

j specifying the j 
j contents of the f 
j channel command wordj 
j in the format j 
j described in the j 
j following text. j 


L_X_J_J 


— 

Byte 

"T 

| Bits 

| Usage 

I .. _ . 

j.__ 

1 

| 

1 0-7 

{Command code 

2-4 

| 8-31 

{Data address 

5 

|32-36 

{Flags 


|37-39 

{Must be zero 


j 40-47 

{Set to zero 

7-8 

|48-63 

jCount 

i_ _ 

.X 

-j.- -- 


Figure 13. Channel Command Word 


Listing Control Instructions 


All four operands must appear. They are 
written, from left to right, as follows: 

1. An absolute expression that specifies 
the command code. This expression's 
value is right-justified in byte 1. 

2. An expression specifying the data 
address. The value of this expression 
is in bytes 2-4. 

3. An absolute expression that specifies 
the flags for bits 32-36 and zeros for 
bits 37-39. The value of this 
expression is right-justified in byte 
5. (Byte 6 is set to zero.) 

4. An absolute expression that specifies 
the count. The value of this 
expression is right-justified in bytes 
7-8. 

The following is an example of a CCW 
statement: 


The listing control instructions are used 
to identify an assembly listing and 
assembly output cards, to provide blank 
lines in an assembly listing, and to 
designate how much detail is to be included 
in an assembly listing, in no case are 
instructions or constants generated in the 
object program. Listing control statements 
except PRINT are not printed, unless the 
statement is continued. Then the first 
card of the statement will be printed. 


TITLE--IDENTIFY ASSEMBLY OUTPUT 


The TITLE instruction enables the 
programmer to identify the assembly listing 
and assembly output cards. The typical 
form of the TITLE instruction statement is 
as follows: 
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r - T -T- 

JName |Operation!Operand 


r — - 

|A special 

T- 

j TITLE 

— r - — - -— 

JOne to 100 

j symbol, a 

1 

j characters. 

j sequence 

1 

jenclosed in 

J symbol, a 

1 

j single 

jvariable 

1 

j apostrophes 

j symbol, or 

! 

! 

jnot used 

I 

1 


j.__ 

_i__ 


The name entry may contain a special 
symbol which is one to four alphabetic or 
numeric characters in any combination. The 
contents of the name entry are then punched 
into columns 73-76 of all the output cards 
for the program except those produced by 
the PUNCH and REPRO assembler instructions. 
Only the first TITLE statement in a program 
may have a special symbol or variable 
symbol in the name entry. The name field 
of all subsequent TITLE statements must be 
blank or contain a sequence symbol. 


The operand field may contain up to 100 
characters enclosed in apostrophes. Any 
ampersands or apostrophes enclosed within 
the surrounding apostrophes must be 
represented by two ampersands or 
apostrophes. 


i r-7- t- 1 

| JName |OperationjOperand j 


|PGM1 |TITLE J'FIRST HEALING' j 

l--L-J.-j 

then, PGW1 is punched into all the output 
cards (columns 73-76) and this heading 
appears at the top of each cage: FIRST 
HEADING. 

If the following statement occurs later 
in the same program: 

r - r -*- T ---1 

|Name (Operation|Operand | 

F-4-4-1 

| j TITLE |'A NEW HEADING* j 

L- X -Jl- J 

then, PGM1 is still punched into the output 
cards, but each following page begins with 
the heading: A NEW HEADING. 

Note : The sequence number of the cards in 

the output deck is contained in columns 
77-80, except those produced by the PUNCH 
and REPRO assembler instructions. 


EJECT--START NEW PAGE 


The double ampersands and apostrophes 
punched into a TITLE card appear as single 
ampersands and apostrophes in a TITLE 
statement of an assembler listing. A 
single apostrophe between the enclosing 
apostrophes simply terminates the operand 
field. A single ampersand initiates an 
attempt to identify a variable symbol. If 
the variable symbol is not identifiable the 
statement is flagged as an error. 


However, it is the number of printed 
characters that are counted in the total 
number of operand characters. The contents 
of the name and operand field are printed 
at the top of each page of the assembly 
listing. 


A program may contain more than one 
TITLE statement. Each TITLE statement 
provides the heading for pages in the 
assembly listing that follow it, until 
another TITLE statement is encountered. 

Each TITLE statement encountered after the 
first one causes the listing to be advanced 
to a new page (before the heading is 
printed) . 

For example, if the following statement 
is the first TITLE statement to appear in a 
program: 


The EJECT instruction causes the next line 
of the listing to appear at the top of a 
new page. This instruction provides a 
convenient way to separate routines in the 
program listing. The typical form of the 
EJECT instruction statement is as follows: 

r-*-7-T'-1 

(Name JOperation|Operand | 

}•-4-4-1 

|Sequence |EJECT |Not used; should | 

jsymbol or j jbe blank j 

jnot used j J j 

L-J-J_J 

If the next line of the listing would 
appear at the top of a new page without the 
EJECT instruction, the EJECT instruction 
has no immediate effect. If one or more 
EJECT statements appear after the first 
EJECT, one or more pages are skipped. A 
TITLE instruction followed immediately by 
an EJECT instruction will result in a page 
with a title line and a statement heading 
line. Text following the EJECT instruction 
will begin at the top of the next page. 


SPACE--SPACE LISTING 


The SPACE instruction is used to insert one 
or more blank lines in the listing. The 
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typical form of the SPACE instruction 
statement is as follows: 

r- r -,- 1 

{Name |Operation!Operand j 

b -1-f-1 

|Sequence |SPACE |A decimal value | 

|symbol orj jor not used f 

|not used j j j 

i_ jl -1-j 

A decimal value is used to specify the 
number of blank lines to be inserted in the 
assembly listing. A blank operand causes 
one blank line to be inserted. If this 
value exceeds the number of lines remaining 
on the listing page, the statement will 
have the same effect as an EJECT statement. 


PRINT—PRINT OPTIONAL DATA 


When OFF is specified, GEN and DATA have 
no effect. When NOGEN is specified, DATA 
has no effect for generated constants. 


If no PRINT statement is encountered, 
the following default option is assumed: 


j Name jOperation j Operand 

j--f-+- 

| (PRINT I ON,NODATA,GEN 

- 1 -J- 

For example, if the statement: 

i-r- t- 

(Name jOperationjOperand 

I-4-+- 

i |DC |XL256* 00* 

I-j-j.- 


l 


H 



H 


The PRINT instruction controls the content 
of the assembly listing. The typical form 
of the PRINT instruction is: 


r - T -j- 

|Name |Operation]Operand 

b - f -j.- 

|Sequence |PRINT I One to three 
jsymbol orj |operands 

jnot used j j 

l- l -i.- 


1 

I 

A 


j 


One to three of the following operands 
are used: 


appears in a program, 256 bytes of zeros 
are assembled. If the statement: 


(Name 

I- 

I 

i- 


"T-T- 

(Operation!Operand 

|PRINT |DATA 


H 


is the last PRINT statement to appear 
before the DC statement, all 256 bytes of 
zeros are printed in the assembly listing. 
However, if there are no previous PRINT 
st at eraents, or: 


ON A listing is printed, 

or 

OFF No listing is printed. 

GEN All statements generated by macro 

instructions are printed, 
or 

NOGEN Statements generated by macro 

instructions are not printed, 
except MNOTE messages which print 
regardless of NOGEN. However, 
the outer macro instruction 
itself will appear in the 
listing. 

DATA Constants are printed out in full 
in the listing, 
or 

NODATA Only the leftmost eight bytes (16 
hexadecimal digits) are printed. 

A program may contain any number of 
PRINT statements. The conditions set by a 
PRINT statement are in effect until another 
PRINT statement is encountered. 

If an operand is omitted, it is assumed 
to be unchanged and continues according to 
its last specification. 


I-T-T-1 

J Name (Operation]Operand | 

1-4-4-1 

j (PRINT jNODATA j 


is the last PRINT statement to appear 
before the DC statement, only eight bytes 
of zeros are printed in the assembly 
listing. 


Program Control Instructions 


The program control instructions are used 
to specify the end of an assembly, to set 
the location counter to a value or halfword 
boundary, to insert previously written 
coding in the program, to specify the 
placement of literals in storage, to check 
the sequence of input cards, to indicate 
statement format, and to punch a card. 
Except for the CNOP and COPY instructions, 
none of these assembler instructions 
generate instructions or constants in the 
object program. 
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ICTL—INPUT FORMAT CONTROL 


ISEQ —INPUT SEQUENCE CHECKING 


The ICTL instruction allows the programmer 
to alter the format of the statements in 
his source module. It can only be used to 
control statements that are read from the 
system input file (SYSIPT). It cannot be 
used to control the format of the input 
from the source statement library. 
Statements that are brought in from that 
library (through macro instructions or COPY 
instructions) are always assumed to be in 
the standard format. 


The ICTL statement must precede all 
other statements, and may only be used 
once. Its format is: 


r- t-t- 1 

|Name | Operation!Operand | 

F---1-f- \ 

|Not used, | ICTL |1-3 decimal j 

jmust not j lvalues of the } 

jbe present j jform b,e,c j 

l _r-j-- j 


Operand b specifies the begin column of 
the source statement. It must always be 
specified, and must be from 1-40, 
inclusive. Operand e specifies the end 
column of the source statement. The end 
column, when specified, must be from 41-80, 
inclusive; when not specified, it is 
assumed to be 71. The column after the end 
column is used to indicate whether the next 
card is a continuation card. Operand c 
specifies the continue column of the source 
statement. The continue column, when 
specified, must be from 2-40 and must be 
greater than b. If the continue column is 
not specified, or if column 80 is specified 
as the end column, the assembler assumes 
that there are no continuation cards, and 
all statements must be contained on a 
single card. The operand forms b,,c and b, 
are invalid. 

If no ICTL statement is used in the 
source program, the assembler assumes that 
1, 71, and 16 are the begin, end, and 
continue columns, respectively. 

The next example designates the begin 
column as column 25. Since the end column 
is not specified, it is assumed to be 
column 71. No continuation cards are 
recognized because the continue column is 
not specified. 

r- t -r---1 

|Name |Operation)Operand | 

F-+-f--I 

| jICTL j 25 j 

i-i_j._j 


The ISEQ instruction is used to check the 
sequence of input cards. The typical form 
of the ISEQ instruction statement is as 
follows: 

-1 

I 

1 


j 


r 

|Name J Operation|Operand 

F-F-F- 

J Not used, | ISEQ JTwo decimal 

jmust not j jvalues of the 

jbe present j jform 1, r, or 

| | jnot used 


The operands 1 and r, respectively, 
specify the leftmost and rightmost columns 
of the field in the input cards to be 
checked. Operand r must be equal to or 
greater than operand 1. Columns to be 
checked must not be between the "begin" and 
"end" columns. 

Sequence checking begins with the first 
card following the ISEQ statement. 
Comparison of adjacent cards makes use of 
the eight-bit internal collating sequence. 
Each card checked must be higher than the 
preceding one. 

An ISEQ statement with a blank operand 
terminates the operation. Checking may be 
resumed with another ISEQ statement. 

Sequence checking is only performed on 
statements contained in the source program. 
Statements inserted by the COPY assembler 
instruction or generated by a macro 
instruction are not checked for sequence. 


PUNCH—PUNCH A CARD 


The PUNCH assembler instruction causes the 
data in the operand to be punched into a 
card. One PUNCH statement produces one 
punched card. As many PUNCH statements may 
be used as are necessary. The typical form 
is: 


r - 7 - T - 1 

JName (Operation|Operand | 


{Sequence jPUNCH jl to 80 characters j 
jsymbol orj {enclosed in j 

jnot used j japostrophes j 

i_j_i_J 

Using character representation, the 
operand is written as a string of up to 80 
characters enclosed in apostrophes. All 
characters, including blank, are valid. 

The position immediately to the right of 
the left apostrophe is regarded as column 
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one of the card to fce punched. The 
assembly program does not process the data 
in the operand of a PUNCH statement other 
than causing it to be punched in a card. 

Fcr each apostrophe or ampersand desired in 


ampersands are reduced to a single 
apostrophe or ampersand. However, they 
ccunt as only cne character in the operand. 

PUNCH statements may occur anywhere 
within a program, except before macro 
definitions. They may occur within a macro 
definition but not between a MEND statement 
and the beginning of the next macro. If a 
PUNCH statement occurs before the first 

jl . i.u A i i. i i 

occxxua $ uxjc icouiwauv. uox u vv x jl jl 

precede all other cards in the object 
program card deck; otherwise the card will 
be punched in place. No sequence number or 
identification is punched in the card. 


REPRO--REPRODUCE FOLLOWING CARD 


The REPRO assembler instruction causes data 
on the following statement line to be 
punched into a card. The data is not 
processed; it is punched in a card and no 
substitution is performed for variable 
symbols. No sequence number or 
identification is punched in the card. One 
REPRO instruction produces one punched 
card. The REPRO instruction may not appear 
before a macro definition. 


the cperand/rwo acostfbphes or ampersands" 
must be written. The two apostrophes or 


r- t-t--- 1 

|Name |Operation|Operand | 

^-4-4- 

|Sequence JORG jA relocatable ex- | 

jsymbol orj jpression or net used j 

jnot used j j j 

i- j -j-j 

Any symbols in the expression must have 

been previously defined. The unpaired 
2 T 0 Xccstsbls symbol xnustn bo dofinod In the 
same control section in which the ORG 
statement appears. 

The location counter is set to the value 
of the expression in the operand. If the 
operand is omitted, the location counter is 

X. Tl ^ Jkm ^ Am j n Vs. « Vs m Vs 

ocu lu a xvA^a li v>ii uiat xo wilder ujr vc nxvjiicx 

than the maximum location assigned for the 
control section up to this point. 

An ORG statement must not be used to 
specify a location below the beginning of 
the control section in which it appears. 

The effect would be to give the location 
counter a large value. For example, the 
statement: 


r- t-t-i 

| Name |Operation|Operand | 

t-4-4-1 

| |ORG |*-500 | 

i_J_I_ j 


is invalid if it appears less than 500 
bytes from the beginning of, the current 
ccntrol section. 


REPRO statements that occur before all If it is desired to reset the location 

statements composing the first or only counter to the next available location in 

ccntrol section will punch cards which the current control section, the following 

precede all cards of the object deck. The statement would be used: 
form is: 


r- t -r- 

| Name |Operation!Operand 

I-- 4 - f - 

| Sequence |REPRO |Not used, should 

jsymbol orj jnot be present 

jnot used j j 


l-X_ L. 


1 

I 

A 

I 

I 

I 

j 


The line to be reproduced may contain 
any combination of up to 80 characters. 
Characters may be entered starting in 
column 1 and continue through column 80 of 
the line. Column 1 of the line corresponds 
to column 1 of the card to be punched. 


I-7-7-1 

|Name |Operation|Operand | 

i-4-4-—j 

| |ORG | | 

L_J_J_—-- 1 

If previous CRG statements have reduced 
the location counter for the purpose of 
redefining a portion of the current control 
section, an ORG statement with an omitted 
operand can then be used to terminate the 
effects of such statements and restore the 
location counter to its highest setting. 


LTORG--BEGIN LITERAL FCCL 

ORG--SET LOCATION COUNTER 

The LTORG instruction causes all literals 
since the previous LTORG or beginning of 

The ORG instruction is used to alter the the program to be assembled at appropriate 

setting of the location counter for the boundaries starting at the first doubleword 

current control section. The typical form boundary following the LTCRG statement. If 

of the ORG instruction statement is: no literals follow the LTORG statement. 
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alignment of the next instruction will 
occur. Bytes skipped are not zeroed. The 
typical form of the LTORG instruction 
statement is: 


j Name 

f- 

| Any 
j symbol 
jor not 
| used 
l- 


j Operation!Operand 

+-f- 


|LTORG 

I 

I 

I 


|Not used, should 
jnot be present 

I 

I 


x 


x 


I 

A 


I 

I 


The symbol represents the address of the 
first byte of the literal pool. It has a 
length attribute of one. 

The literal pool is organized into four 
segments within which the literals are 
stored in order of appearance, dependent on 
the divisibility properties of their object 
lengths (dup factor times total explicit or 
implied length). The first segment 
contains all literals whose object length 
is a multiple of eight. Those remaining 
literals with lengths divisible by four are 
stored in the second segment. The third 
segment holds the remaining even length 
literals. Any literals left over have odd 
lengths and are stored in the fourth 
segment. 


Since each literal pool begins at a 
doubleword boundary, this guarantees that 
all segment one literals are doubleword, 
segment two fullword, and segment three 
halfword aligned, with no space wasted 
except, possibly, at the pool origin. 


Literals from the following statement 
are in the pool, in the segments indicated 
by the circled numbers. 


MVC A (6) ,=3H * 1 * 
AD 2,=D'1 * 

LM 3,5,=3F'1 * 

IC 2 ,=XL1'1' 

At 2 ,=D* 2* 


© 

© 


© 

© 


Special Addressing Consideration 


Any literals used after the the last LTORG 
statement in a program are placed at the 
end of the first control section. If there 
are no LTORG statements in a program, all 
literals used in the program are placed at 
the end of the first control section. In 
these circumstances the programmer must 
ensure that the first control section is 
always addressable. This means that the 
base address register for the first control 
section should not be changed through usage 


in subsequent control sections. If the 
programmer does not wish to reserve a 
register for this purpose, he may place a 
LTORG statement at the end of each control 
section, thereby ensuring that all literals 
appearing in that section are addressable. 


CNOP—CONDITIONAL NO OPERATION 


The CNOP instruction allows the programmer 
to align an instruction at a specific word 
boundary. If any bytes must be skipped in 
order to align the instruction properly, 
the assembler insures an unbroken 
instruction flow by generating no-operation 
instructions. This facility is useful in 
creating calling sequences consisting of a 
linkage to a subroutine followed by 
parameters such as channel command words 
(CCW) . 

The CNOP instruction insures the 
alignment of the location counter setting 
to a halfword, word, or doubleword 
boundary. If the location counter is 
already properly aligned, the CNOP 
instruction has no effect. If the 
specified alignment requires the location 
counter to be incremented, one to three 
no-operation instructions are generated, 
each of which uses two bytes. 

The typical form of the CNOP instruction 
statement is as follows: 

r-7- t---1 

|Name JOperation|Operand | 

t -7+- i --I 

|Sequence |CNOP (Two absolute | 

jsymbol orj |expressions of j 

|not used j jthe form b,w | 

L-J-J- 1 


Any symbols used in the expressions in 
the operand field must have been previously 
defined. 

Operand b specifies at which byte in a 
word or doubleword the location counter is 
to be set; b can be 0, 2, 4, or 6. Operand 
w specifies whether byte b is in a word 
(w=4) or doubleword (w=8) . The following 
pairs of b and w are valid: 

b,w Specifies 

0,4 Beginning of a word 

2,4 Middle of a word 

0,8 Beginning of a doubleword 

2.8 Second halfword of a doubleword 

4.8 Middle (third halfword) of a 
doubleword 

6.8 Fourth halfword of a doubleword 
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Figure 14. CNOP Alignment 


Figure 14 shows the position in a double 
word that each of these pairs specifies. 
Note that both 0,4 and 2,4 specify two 
locations in a doubleword. 

Assume that the location counter is 
currently aligned at a doubleword boundary. 
Then the CNOP instruction in this sequence: 


r- T ---j---1 

(Name |Operation!Operand J 


j jCNOP j 0,8 j 

| |BALR 12,14 | 

l-X-X_J 


has no effect. However, this sequence: 


r--- t -r- 1 

| Name |Operation!Operand | 


j jCNOP j 6,8 j 

1 |BALR J2,14 j 

L-X-X_J 

causes three branch-on-conditions 
(no-operations) to be generated, thus 
aligning the BALR instruction at the last 
halfword in a doubleword as follows: 


r - T -f- 1 

| Name |Operation!Operand f 


-T-- 


j BCR 

1 0,0 

j BCR 

10,0 

j BCR 

10,0 

j BALR 

1 2,14 




After the BALR instruction is generated, 
the location counter is at a doubleword 
boundary, thereby insuring an unbroken 
instruction flow. 


Note : If the location counter is on an 
odd-numbered byte-boundary when a CNOP 
instruction is encountered, normal 
alignment occurs before the CNOP is 
processed. 


COPY--COPY PREDEFINED SOURCE CODING 


The COPY instruction obtains source 
language coding from a system library and 
includes it in the program currently being 
assembled. Under the DCS D Assembler, 10K 
Variant, the coding to be included is 
obtained from the system source statement 
library. Under the DOS D Assembler, 14K 
Variant, and the DCS F Assembler, the 
coding to be included is obtained from the 
private source statement library, if one is 
assigned, or from the system source 
library, in that order of precedence. 

Under the TOS D Assembler, 10K and 14K 
Variants, the coding to be included is 
obtained from the standard private library. 
The form of the COPY instruction statement 
is as follows: 


i —-— - 

|Name 

L 

J Operation|Operand 
j. 

r 

JNot used, 
jmust not 
jbe present 

L_- 

j COPY 

1 

1 

.J— -- 

T 

|Cne symbol 

1 

1 


Ihe operand is a symbol that identifies 
the section of coding to be copied. The 
symbol must not be the same as the mnemonic 
operation code of a macro definition in the 
source statement library. 

The assembler inserts the requested 
coding immediately after the COPY statement 
is encountered. The requested coding may 
not contain another CCPY statement. 

If identical COFY statements are 
encountered, the coding they request is 
brought into the program each time. 

Copied text is always in the normal 
format and is not governed by ICTL usage. 
See "Copy Statements" in Section 7 for 
further information. The procedure for 
placing source language ceding in the 
system library is described in the System 
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Control and System Service Programs 
publication listed in the "Preface." 


END—END ASSEMBLY 


The END instruction terminates the assembly 
of a program. It may also designate a 
point in the program or in a separately 
assembled program to which control may be 
transferred after the program is loaded. 

The END instruction must always be the last 
statement in the source program. 

The typical form of the END instruction 
statement is as follows: 


|Name j Operation!Operand j 

I--+-f-^ 

|A sequence | END |A relocatable 1 

jsymbol or j |expression or 1 

jnet present] jnot present j 

i-j.- j. _j 


The operand specifies the point to which 
control may be transferred when loading is 
complete. For example: 


Name 

| Operation|Operand 

j. j. 


NAME 

|CSECT 

T 

1 


AREA 

j DS 

150F 


EEGIN 

j BALR 

12,0 



j USING 

I* 

I*r2 

1 



1 * 

I* 

j END 

J_ 

1 

1 

jBEGIN 



Note : If macro instructions from the 
Source Statement library are included in an 
assembly, errors detected during macro 
editing will be flagged after the END 
statement. The error messages do not 
follow the macro instructions, because the 
source statements are not available to the 
assembler during macro editing. Errors 
detected while editing Programmer Macros 
will be flagged inline. 
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Part 3—Conditional Assembly and Macro Facilities in the 

Assembler Language 


Organization of this Part of the Publication 


Section 6 gives an introduction to the conditional assembly and macro 
facilities in the assembler language. 

Sections 7 and 8 describe the basic rules for preparing macro 
definitions and for writing macro instructions. 

Section 9 describes the rules for writing conditional assembly 
instructions. 

Section 10 describes additional features including rules for de¬ 
fining global SET symbols, preparing keyword and mixed-mode macro 
definitions, and writing keyword and mixed-mode macro instructions. 

Appendix G contains a reference summary of the complete macro 
facilities. 

Examples of the use of the features of the language appear through¬ 
out the remainder of the publication. These examples illustrate the 
use of particular features. However, they are not meant to show the 
full versatility of these features. 
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Section 6. Introduction to the Conditional Assembly and 

Macro Facilities 


The DOS/TOS conditional assembly and macro 
facilities are part of the DOS/TOS 
assembler language. 

Conditional assembly allows one to 
specify assembler language statements which 
may or may not be assembled, depending upon 
conditions evaluated at assembly time. 
Conditional assembly statements are used to 
define, set, change, and test values during 
the course of the assembly itself. 

The conditional assembly instructions 
may be used to vary the sequence of 
statements generated for each occurrence of 
a macro instruction. Conditional assembly 
instructions may also be used outside macro 
definitions, i.e. , among the assembler 
language statements in the program. 

The macro facilities provide the 
programmer with a convenient way of 
generating desired sequences of machine or 
certain assembler instructions many times 
in one or more programs. This is 
accomplished by writing a macro definition. 

This macro definition is written only 
once, and a single statement, a macro 
instruction statement, is written each time 
a programmer wants to generate the desired 
sequence of statements. 

The macro facilities simplify the coding 
of programs, reduce the chance of 
programming errors, and ensure that 
standard sequences of statements are used 
to accomplish desired functions. 


The Macro Instruction Statement 


A macro instruction statement (also called 
a macro instruction) is a source program 
statement used to provide information for 
generating machine and assembler 
instructions from a macro definition. The 
generated instructions are source 
statements which are then processed by the 
assembler program. 

Three types of macro instructions may be 
written. Each type has a different form of 
operand. They are: 

1. Positional (Sections 7 and 8) . 

2. Keyword (Section 10) . 


3. Mixed-mode (Section 10) . 

Positional macro instruction operands 
are written in a fixed order. 

Keyword macro instruction operands can 
be written in any order. 

Mixed-mode macro instruction operands 
are a combination of both positional and 
keyword operands. That is, certain operand 
entries (positional) must be written in a 
fixed order; other operand entries 
(keyword) can be specified in any order. 


The Macro Definition 


Before a macro instruction can be 
assembled, a macro definition must be 
available to the assembler. 

A macro definition is a set of 
statements that provide the assembler with: 

1. The name entry, mnemonic operation 
code, and the form of the macro 
instruction operand, and 

2. The sequence of statements the 
assembler uses when the macro 
instruction appears in the source 
program. 

Every macro definition consists of a 
macro definition header statement, a macro 
instruction prototype statement, a sequence 
of model statements, COPY statements, 

MEXIT, MNOTE, or conditional assembly 
instructions, and a macro definition 
trailer statement. 

The macro definition header and trailer 
statements denote the beginning and end, 
respectively, of a macro definition. 

The macro instruction prototype 
statement specifies the name entry, 
mnemonic operation code, and the type of 
the macro instruction operand. 

The model statements contained in a 
macro definition may be used by the 
assembler to generate machine instructions 
and certain assembler instructions that 
replace each occurrence of the macro 
instruction. 

The COPY statements may be used to copy 
model statements, MEXIT instructions, MNOTE 
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instructions, and conditional assembly 
instructions from a source statement 
library into a macro definition. 

The MEXIT instruction can be used to 
terminate processing of a macro definition. 

The MNOTE instruction can be used to 
generate a message. 

The conditional assembly instructions 
may be used to vary the sequence of 
statements generated for each occurrence of 
a macro instruction. Conditional assembly 
instructions may also be used outside macro 
definitions, i.e., among the assembler 
language statements in the program. 

If a macro definition is inline with an 
assembly, it is called a programmer macro. 


Source Statement Libraries 


The same macro definition may be made 
available to more than one source program 
by placing the macro 'definition in the 
system source statement library. The macro 
definition then oecomes a system macro. 

This system library is a collection of 
macro definitions that can be used by all 
the assembler language programs in an 
installation. Once a macro definition has 
been placed on the system souice statement 
library it may be used by writing a 
corresponding macro instruction in a source 
program. Macro definitions must be in the 1 
syst em source statement library unaer the 
*T5amc "llAme as the prototyp e. Tne procedure 
"*for placing macro definitions in the system 
source statement library is described in 
the System Control and System Service 
Programs publication listed in the 
"Prefac e." 

System macro definitions provided by IBM 
are described in the Supervisor and 
Input/Output Macros publication, also 
listed in the "preface." 

A macro definition may be made available 
to a specific assembly by placing the macro 
definition in a private source statement 
library. If the private source statement 
library is assigned at the time of 
assembly, the macro definitions in the 
private source statement library may be 
used by writing a corresponding macro 
instruction in a source program. The macro 
definitions in the private source statement 
library must be under the same name as the 
prototype. The procedure for placing macro 
definitions in the private source statement 
library is described in the System Control 
and System Service Programs publication 
listed in the "Preface." 


Editing errors in user-supplied macro 
definitions are found at the time the macro 
is read from the source statement library, 
i.e,, after the END card. To determine 
where these errors are, it is necessary to 
punch all such macros, including inner 
macros, and insert them then in the source 
program as programmer macros. To aid in 
debugging it is advisable to run all macros 
as programmer macros before incorporating 
them in a source statement library. 


Varying the Generated Statements 


Each time a macro instruction appears in 
the source program, it is replaced by the 
same sequence of assembler language 
statements. Conditional assembly 
instructions, however, may be used to vary 
the number and format of the generated 
statements. 


VARIABLE SYMBOLS 


A variable symbol is a type of symbol that 
is assigned various values by either the 
programmer or the assembler. Thus, 
variable symbols allow different values to 
be assigned to one symbol. When the 
assembler uses a macro definition to 
determine what statements are to replace a 
macro instruction, variable symbols in the 
model statements are replaced with the 
current values assigned to them. 

A variable symbol is written as an 
ampersand followed by from one to seven 
letters and/or digits, the first of which 
must be a letter. 


Types of Variable Symbols 


There are three types of variable symbols: 
symbolic parameters, system variable 
symbols, and SET symbols. The SET symbols 
are further broken down into SETA symbols, 
SETB symbols, and SETC symbols. The three 
types of variable symbols differ in how 
they are assigned values. 


Assigning Values to Variable Symbols 


Symbolic parameters are assigned values by 
the programmer each time he writes a macro 
instruction. 
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System variable symbols, except 
&SYSPARM. are assianed values by the 
assembler each time it processes a macro 
instruction. 

SET symbols are assigned values by the 
programmer by means of conditional assembly 
instructions. 


definitions. All SET symbols used for this 
purpose must be defined as global SET 
symbols. All other SET symbols must be 
defined by the programmer as local SET 
symbols. Local SET symbols and the other 
variable symbols (that is, symbolic 
parameters and system variable symbols) are 
local variable symbols. Global SET symbols 
are global variable symbols. 


Global SET Symbols 


The values assigned to SET symbols in one 
macro definition may be used in other macro 
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Section 7. How to Prepare Macro Definitions 


A macro definition consists of: 

1. A macro definition header statement. 

2. A macro instruction prototype 
statement. 

3. Zero or more model statements, COPY 
statements, MEXIT, MNOTE, or 
conditional assembly instructions. 

4. A macro definition trailer statement. 

Except for MEXIT, MNOTE, and conditional 
assembly instructions, this section of the 
publication describes the statements that 
may be used to prepare macro definitions. 
Conditional assembly instructions are 
described in Section 9. MEXIT and MNOTE 
instructions are described in Section 10. 


must be the last statement in every macro 
definition. The form of this statement is: 

r- T _- T _- 1 

jName juperationjOperand j 

f-4-4-1 

|Sequence |MEND |Not used, must | 

jsymbol orj jnot be present j 

jnot used | j j 

l_-L_I-J 

This statement also tells the assembler 
to terminate processing of a macro 
definition. Processing can be terminated 
at some other point in a macro definition 
through the MEXIT instruction. 

Macro Instruction Prototype 


Macro definitions in a source program 
must appear before all PUNCH and REPRO 
statements which appear in the main 
program. Specifically, only the listing 
control instructions (EJECT, PRINT, SPACE, 
and TITLE), ICTL and ISEQ instructions, and 
comments statements may occur before the 
macrc definitions. All but the ICTL 
instruction may appear between macro 
definitions if there is more than one 
definition in the source program. 

Note : A macro definition cannot appear 
within a macro definition. 


MACRO-Macro Definition Header 


The macro definition header statement 
denotes the beginning of a macro 
definition. It must be the first statement 
in every macro definition. The form of 
this statement is: 

r - r - T - 

|Name | Operation)Operand 

1 - 4 -j.- 

|Not used, | MACRO |Not used, must 

jmust not j jnot be present 

jbe present j j 

L--L- L - 


MEND-Macro Definition Trailer 


The macro instruction prototype statement 
(also called the prototype statement) 
specifies the name entry, mnemonic 
operation code, and the form of all macro 
instructions that refer to the macro 
definition. It must be the second 
statement of every macro definition. The 
typical form of this statement is: 

r- t-t-1 

|Name |Operation|Operand | 

f-4-4-i 

j A symbolicfA symbol |Zero to 100 (200 | 

jparameter j jfor F assembler) j 

jor not j jsymbolic parameters,! 

Jused j jseparated by commas j 

i _j._j. -j 

The symbolic parameters are used in the 
macro definition to represent the name 
entry and operands of the corresponding 
macro instruction. A description of 
symbolic parameters appears following 
"Model Statements." 

The name entry of the prototype 
statement may be unused or it may contain a 
symbolic parameter. 

| The symbol in the operation entry is the 

| mnemonic operation code that must appear in 
j all macro instructions that refer to this 
J macro definition. The mnemonic operation 
code must not be the same as the mnemonic 
operation code of another macro definition 
in the source program or of a machine 
instruction or assembler instruction. 


The operand may contain zero to 100 (200 

The macro-definition trailer statement for F assembler) symbolic parameters 

denotes the end of a macro definition. It separated by commas. 
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The following is a prototype statement. 


r- T -r- 

|Name |Operation|Operand 

y -+-f- 

I SNAME I MOVE |STO,SFROM 

L_X-X- 


1 


A 

I 


Alternate Statement Form 


The prototype statement may be written in a 
form different from that used for machine 
or assembler instructions. The normal form 
is described in Part 1 of this publication. 
The alternate form described here allows 
the programmer to write an operand cn each 
line, and allows the interspersing of 
operands and comments in the statement. 


In the alternate form, as in the normal 
form, the name and operation entries must 
appear on the first line of the statement, 
and at least one blank must follow the 
operation entry on that line. Both types 
of statement forms may be used in the same 
prototype statement. 


T-T 

Oper- 


T-1 


Name | ationJOperand Comments 

X X 

NAMEl joPI 

1 

4 

|0PERAND1,CFERAND2,CPERAN 
|D3 the normal form 

1 

NAME2|0P2 

1 

1 

JOPERAND1, THIS IS THE AL 
JOPERAND2,OPERAND3, TERNA 


t-H 


I- 

NAME3 


f- 


TE STATEMENT 
FORM 


H 

x| 

x| 

XI 


-H 

x| 

x| 

xi 


0P3 


OPERAND 1 , THIS IS A COME 
CPEPANE2,0PERANE3,CPERAN 
E4,OPERAND5 INATION OF 
BOTH STATEMENT FORMATS 


Model Statements 


Model statements are the macro definition 
statements from which the desired sequences 
of machine instructions and certain 
assembler instructions are generated. Zero 
or mere model statements may follow the 
prototype statement. A model statement 
consists of one to four entries. They are, 
from left to right, the name, operation, 
operand, and comments entries. 


The rules for using the alternate 
statement form are: 

1. If an operand is followed by a comma 
and a blank, and the column after the 
end column contains a nonblank 
character, the operand entry may be 
continued on the next line starting in 
the continue column. More than one 
operand may appear on the same line. 

2. Comments may appear after the blank 
that indicated the end of an operand, 
up to and including the end column. 

3. If the next line starts after the 
continue column, the information 
entered on that line is considered to 
be comments, and the operand field is 
considered terminated. Any subsequent 
continuation lines are considered to 
contain only comments. 


Note : A prototype statement may be written 
on as many continuation lines as is 
necessary to contain 100 (200 for F 
assembler) operands and associated 
comments. 

The following examples illustrate: (1) 
the normal statement form, (2) the 
alternate statement form, and (3) the 
combination of both statement forms. 


The name entry may be unused, or it may 
contain an ordinary symbol, a sequence 
symbol or a variable symbol, depending on 
the particular statement. (Neither * nor 
. * may be substituted in the begin column 
cf a model statement.) 

The operation entry may contain any 
machine, assembler, or macro instruction 
mnemonic operation code, except COPY, ENE, 
ICTL, ISEQ, and PRINT; or it may contain a 
variable symbol. Variable symbols may not 
be used to generate the following mnemonic 
operation codes, nor may variable symbols 
be used in the name and operand entries of 
these instructions: COPY, END, ICTL, or 
ISEQ. Variable symbols may not be used to 
generate CSECT, DSECT, PRINT, REFRO, START, 
MACRO, MEND, MEXIT, LCLA, LCLB, LCLC, GBLA, 
GBLB, GBLC, SETA, SETE, SETC, AIF, AIFE, 
AGO, AGOB, ANCF, or macro instruction 
mnemonic operation codes. Variable symbols 
may not be used to generate the name and 
operation code of the ACTR instruction. 

Variable symbols may also be used 
outside of macro definitions to generate 
mnemonic operation codes with the preceding 
restrictions. 

Although COPY statements may not be used 
as model statements, they may be part of a 
macro definition. The use of COPY 
statements is described under "COPY 
Statements." 
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The operand entry may contain ordinary 
symbols or variable symbols. After 
substitution, the operand must not be 
greater than 127 (255 for F assembler) 
characters. Model statement fields must 
follow the rules for paired apostrophes, 
ampersands, and blanks, as macro 
instruction operands. (See "Macro 
Instruction Operands" in Section 8.) 
Sequence symbols must appear in the operand 
entry of AGO and All instructions. 

The comments entry may contain any 
combination of characters. Substitution by 
the use of variable symbols is not allowed. 

If a REPRO statement is used as a model 
statement, it must be explicitly written in 
the operation entry. It may not be 
generated as a result of replacing a 
variable symbol by its value. Also, the 
line following it may not contain variable 
symbols. Substituted statements may not 
have blanks in any fields except between 
paired apostrophes. They may not have 
leading blanks in the name or operand 
fields. 


Symbolic Parameters 


SIN AREA (contains a special 

character, i.e. , blank, 
other than initial 
ampersand) 


The following is an example of a macro 
definition. Note that the symbolic 
parameters in the model statements appear 
in the prototype statement. 



|Name |Operation|Operand 

L _L 


r T 

T 

Header 

j (MACRO 

1 

Prototype 

j SNAME (MOVE 

|STC,SFROM 

Model 

SNAME ST 

(2,SAVE 

Model 

! |L 

|2,SFROM 

Model 

(ST 

j 2 , STO 

Model 

1 |L 

12,SAVE 

Trailer 

| (MEND 

1 

_-L_ _ __ 


Symbolic parameters in model statements 
are replaced by the characters of the macro 
instruction operand that correspond to the 
symbolic parameters. 


A symbolic parameter is a type of variable 
symbol consisting of an ampersand followed 
by one to seven letters anchor numbers, the 
first of which must be a letter-. Symbolic 
parameters appear in prototype and model 
statements. They are assigned values by 
the programmer when he writes a macro 
instruction. The programmer may vary 
statements that are generated for each 
occurrence of a macro instruction by 
varying the values assigned to symbolic 
parameters. 


In the following example the characters 
HERE, FIELDA, and FIELEE of the MOVE macro 
instruction correspond to the symbolic 
parameters SNAME, STC, and SFROM, 
respectively, of the MOVE prototype 
statement. 


r - T - T - , 

(Name (Operation|Operand | 

I-4-+-1 

jHERE |MOVE jFIELDA,FIELDB | 

l_J--L-J 


The programmer should not use 6SYS as 
the first four characters of a symbolic 
parameter. 

The following are valid symbolic 
parameters: 

SREADER SL00P2 
SA23456 SN 
SX4F2 6S4 

The following are invalid symbolic 
parameters: 

CARDAREA 

S256B 

SAREA2456 

SECD (34) 


(first character is not an 
ampersand) 

(first character after 
ampersand is not a letter) 
(more than seven characters 
after the ampersand) 

(contains a special 
character other than initial 
ampersand) 


Any occurrence of the symbolic 
parameters SNAME, STO, and SFROM in a model 
statement will be replaced by the 
characters HERE, FIELDA, and FIELDB, 
respectively. If the preceding macro 
instruction was used in a source program, 
the following assembler language statements 
would be generated: 


f-1-T-1 

(Name (Operation(Operand ( 


IUI M -I- T 

—r- 


HERE 

ST 

12,SAVE 


|L 

j2,FIELDB 


ST 

(2,FIELDA 



(2,SAVE 





The following example illustrates 
another use of the MOVE macro instruction 
using operands different than these that 
appear in the preceding example. 
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r - , - T - 

| Name |Operation}Operand 


F-f--f- 

Macro |LABELjMOVE jIN,OUT 

h-f-f- 

Generated j LABEL|ST J 2, SAVE 

Generated! |L j2,OUT 

Generated! JST |2,IN 

Generated! |L j2,SAVE 

i-j.-j- 


I 

A 

I 

I 

1 

I 


If a symbolic parameter appears in the 
comments field of a model statement, it is 
not replaced by the corresponding 
characters of the macro instruction. 


Concatenating Symbolic Parameters with 
Other Characters or Other Symbolic 
Parameters 


Concatenation is the process of linking or 
joining together in a sequence, with a 
specified order. To concatenate is to join 
together in a specified order. 

If a symbolic parameter in a model 
statement is immediately preceded or 
followed by other characters or another 
symbolic parameter, the characters that 
correspond to the symbolic parameter are 
combined, in the order given, in the 
generated statement, with the other 
characters or the characters that 
correspond to the other symbolic parameter. 
This process is called concatenation. 

The macro definition, macro instruction, 
and generated statements in the following 
example illustrate these rules. 


r- r - T - 

|Name }Operation!Operand 

I-- f - f - 


Header | |MACRO 

Prototype j SNAME|MOVE 


Model 
Model 
Model 
Model 
Trailer 

Macro 


SNAME|STSTY 


Generated! 
Generated! 
Generated j 


I 

j STY,SP,STO,SFROM 
j 2,SAVEAREA 


H 



j LSTY 
j STSTY 
| LSTY 
j MEND 
_ j- 

j 2, 6PSFROM 
j 2 , SP6T0 
j 2,SAVEAREA 

1 

.... j______ 

HERE 

[move 

1_ 

j D,FIELD,A,E 

L _ . 

HERE 

T 

J STD 
j LD 
j STD 
j LD 

-J.- 

r 

J 2,SAVEAREA 

J 2,FIELDB 
j2,FIELDA 
j 2,SAVEAREA 


The symbolic parameter STY is used in 
each of the four model statements to vary 
the mnemonic operation code of each of the 
generated statements. The character D in 
the macro instruction corresponds to 
symbolic parameter STY, Since STY is 


preceded by other characters (i.e., ST and 
L) in the model statements, the character 
that corresponds to STY (i.e., C) is 
concatenated with the other characters to 
form the operation fields of the generated 
statements. 

The symbolic parameters SP, SC, and 
SFROM are used in two of the model 
statements to vary part of the operand 
fields of the corresponding generated 
statements. The characters FIELD, A, and B 
correspond to the symbolic parameters SP, 
STO, and SFROM, respectively. Since SP is 
followed by SFROM in the second model 
statement, the characters that correspond 
to them (i.e., FIELD and E) are 
concatenated to form part of the operand 
field of the second generated statement. 
Similarly, FIELD and A are concatenated to 
form part of the operand field of the third 
generated statement. 

If the programmer wishes to concatenate 
a symbolic parameter with a letter, digit, 
left parenthesis, or period following the 
symbolic parameter he must immediately 
fcllcw the symbolic parameter with a 
period. A period is optional if the 
symbolic parameter is to be concatenated 
with another symbolic parameter, or a 
special character other than a left 
parenthesis or another period that follows 
it. 


If a symbolic parameter is immediately 
followed by a period, then the symbolic 
parameter and the period are replaced by 
the characters that correspond to the 
symbolic parameter. A period that 
immediately follows a symbolic parameter 
dees not appear in the generated statement. 

The following macro definition, macro 
instruction, and generated statements 
illustrate these rules. 


I-T-T- 

|Name |Operation|Operand 

H 


-i - 

Header | JMACRO 

Prototype|SNAME|MOVE 


Model 
Model 
Model 
Model 
Trailer 

Macro 


1 


SNAME|ST 

|L 

JST 
|L 

j MEND 
-+■ 


HERE JMOVE 


b 


Generated|HERE |ST 


Generated| 
Generated} 
Generated j 


j ST 


j SP,SMS,SRI,6R2 
j SRI ,SS. (SR2) 

|SRI,SP.E 
j SRI,SP . A 
j SRI ,SS. (SR2) 


| FIELD,SAVE, 2,4 

+ - 

12,SAVE (4) 
|2,FIELEE 
|2,FIELDA 
j2,SAVE (4) 

.jL_ 


The symbolic parameter SP is used in the 
second and third model statements to vary 
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part of the operand field of each cf the 
corresponding generated statements. The 
characters FIELD of the macro instruction 
correspond to £P. Since &P is to he 
concatenated with a letter (i.e., fi and A) 
in each of the statements, a period 
immediately follows SP in each of the model 
statements. The period does not appear in 
the generated statements. 

Similarly, symbolic parameter SS is used 
in the first and fourth model statements to 
vary the operand fields of the 
corresponding generated statements. SS is 
followed by a period in each of the model 
statements, because it is to be 
concatenated with a left parenthesis. The 
period does not appear in the generated 
statements. 


Comments Statements 


A model statement may be a comments 
statement. A comments statement consists 
of an asterisk in the begin column, 
followed by comments. The comments 
statement is used by the assembler to 
generate an assembler language comments 
statement, just as other model statements 
are used by the assembler to generate 
assembler language statements. 

The programmer may also write comments 
statements in a macro definition which are 
not to be generated. These statements must 
have a period in the begin column, 
immediately followed by an asterisk and the 
comments. 

The first statement in the following 
example will be used by the assembler to 
generate a comments statement; the second 
statement will not. 

r-r-1- 1 

jName JOperation}Operand | 

\r - x -*- \ 

j* THIS STATEMENT WILL BE GENERATED j 

|.* THIS ONE WILL NOT BE GENERATED j 

l_J 

The use of variable symbols for 
substitution in comments statements is not 
allowed. The * or .* of a comment 


statement, therefore, cannot be created by 
substitution for a variable symbol. 


COPY Statements 


A COPY statement is not a model statement. 
COPY statements may be used to copy model 
statements and MEXIT, MNOTE, and 
conditional assembly instructions into a 
macro definition from a system library, 
just as they may be used outside macro 
definitions to copy source statements into 
an assembler language program. Under the 
DOS D Assembler, 10K Variant, the coding to 
be included is obtained from the system 
source statement library. Under the EOS E 
Assembler, 14K Variant, and the DOS F 
Assembler, the coding to be included is 
obtained from the private source statement 
library, if one is assigned, or from the 
system source library, in that order of 
precedence. Under the TCS D Assembler, 10K 
and 14K Variants, the coding to be included 
is obtained from the standard private 
library. 

The form of this statement is: 


r~ — — 

(Name 

L 

| Operation|Operand 

.j. j. 

- 1 

1 

_1 

r - 

|Not used. 

T 

j COPY 

T 

|A symbol 

l 

1 

jmust not 

1 

1 

1 

jbe present 

i___ . 

1 

1 

_ jl _ 

! 


The symbol in the operand entry 
identifies the section of coding to be 
copied. The symbol must not be the same as 
the operation mnemonic of a macro 
definition in a source statement library. 
Any statement that may be used in a macro 
definition may be part of the copied 
coding, except MACRO, MEND, COPY, and 
prototype statements. 

Statements copyed into the program must 
obey the restrictions on ordering of 
statements. For example, COPY must be 
between global and local declarations in 
the macro definition or in the main program 
if the copyed text contains global and 
local declarations. 
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Section 8. How to Write Macro Instructions 


The typical form of a macro instruction is: 

r - T -T- 1 

|Name |OperationlOperand J 

(.-f-j---j 

|A symbol, |Mnemonic JZero to 100 (200 j 

(sequence joperation!for F assembler) ] 

jsymbol, or|code (operands, separated j 

(not used j (by commas j 

i-r- jl-_J 

The name entry of the macro instruction 
may contain a symbol. The symbol will net 
be defined in the generation process unless 
a symbolic parameter appears in the name 
entry of the prototype and the same 
parameter appears in the name entry of a 
generated model statement. 

The operation entry contains the 
mnemonic operation code of the macro 
instruction. The mnemonic operation code 
must be the same as the mnemonic operation 
code of a macro definition in the source 
program or in a source statement library. 

The macro definition with the same 
mnemonic operation code is used by the 
assembler to process the macro instruction. 
Under the DOS D Assembler, 10K Variant, the 
macro definition is obtained from an inline 
programmer macro definition or from the 
system source statement library, in that 
order of precedence. Under the DCS D 
Assembler, 14K Variant, and the DOS F 
Assembler, the macro definition is obtained 
from an inline programmer macro definition, 
a private source statement library, if one 
is assigned, or the system source statement 
library, in that order of precedence. 

Under the TOS E Assembler, 10K and 14K 
Variants, the macro definition is obtained 
from an inline programmer macro definition 
or from the standard private library, in 
that order of precedence. 

The placement and order of the operands 
in the macro instruction may be determined 
by the placement and order of the symbolic 
parameters in the operand entry of the 
prototype statement. 

Macro Instruction Operands 

Any combination of up to 127 (255 for 
assembler F) characters may be used as a 
macro instruction operand provided that the 
following rules concerning apostrophes, 
parentheses, equal signs, ampersands, 
commas, and blanks are observed. 


Paired Apostrophes . An operand may contain 
one or more sequences of characters, each 
of which is enclosed within single 
apostrophes. (The sequence of characters 
itself may contain an even number of 
apostrophes.) The single apostrophes, 
which enclose the sequence of characters, 
are called paired apostrophes. 

The first sequence of characters starts 
with the first apostrophe in the operand. 
Subsequent character sequences start with 
the first apostrophe after the apostrophe 
that ends the previous sequence cf 
characters. 

In the following example; there are two 
sequences of characters enclosed within 
single apostrophes. Therefore, there are 
twe sets of paired apostrophes: the first 
and fourth apostrophes, and the fifth and 
sixth apostrophes. 

'A''B'C'D* 

An apostrophe (not within paired 
apostrophes) , immediately followed by a 
letter, and immediately preceded by the 
letter I (when I is preceded by any special 
character other than an ampersand), is not 
considered in determining paired 
apostrophes. For instance, the apostrophe 
in the following example is not considered. 

L'SyFBCI 

'AL*SYMBOL* is an invalid operand. 

Paired Parentheses . There must be an equal 
number of left and right parentheses. The 
nth left parenthesis must appear to the 
left of the nth right parenthesis. 

Paired parentheses are a left 
parenthesis and a following right 
parenthesis without any other parentheses 
intervening. If there is more than one 
pair, each additional pair is determined by 
removing any pairs already recognized and 
reapplying the above rule for paired 
parentheses. For instance, in the 
following example the first and fourth, the 
second and third, and the fifth and sixth 
parentheses are each paired parentheses. 

(A (B) C) D (E) 

A parenthesis that appears between 
paired apostrophes is not considered in 
determining paired parentheses. For 
instance, in the following example the 
middle parenthesis is not considered. 
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(') •) 

Equal Signs . An equal sign can only occur 
as the first character in an operand or 
between paired apostrophes or paired 
parentheses. The following examples 
illustrate these rules. 

=F'32' 

' C=D' 

E (P—G) 

Ampersands . Except as noted under "inner 
Macro Instructions", each sequence of 
consecutive ampersands must be an even 
number of ampersands. The following 
example illustrates this rule. 

££123££££ 

Commas . A comma indicates the end of an 
operand, unless it is placed between paired 
apostrophes or paired parentheses. The 
following example illustrates this rule. 


alternate form is described in Section 7, 
under the subsection "Macro Instruction 
Prototype." 


Omitted Operands 

If an operand that appears in the prototype 
statement is omitted from the macro 
instruction, then the comma that would have 
separated it from the next operand must be 
present. If the last operand (s) is omitted 
from a macro instruction, then the comma (s) 
separating the last operand (s) from the 
next previous operand may be omitted. 

The following example shows a macro 
instruction preceded by its corresponding 
prototype statement. The macro instruction 
operands that correspond to the third and 
sixth operands of the prototype statement 
are omitted in this example. 


(A ,B) C 1 ,• 

Blanks . Except as noted under "Statement 
Form", a blank indicates the end of the 
operand entry, unless it is placed between 
paired apostrophes. The following example 
illustrates this rule. 


'A B C* 


The following are valid macro 
instruction operands: 


SYMBOL 

123 

X * 18 9A * 

* 

L'NAME 
'TEN = 10' 
'COMMA IS ,' 


A+2 

(TO (8) , FROM) 

0 (2,3) 

=F* 4096' 

AB££9 

•PARENTHESIS IS ) * 
'APOSTROPHE IS'" 


The following are invalid macro 
instruction operands: 


r - T - T -1 

JName |Operation!Operand | 

I--4-4-, 

j j EXAMPLE j£A,£B,£C,£D,£E,£F j 

j jEXAMPLE j17,* +4,,AREA,FIELD (6) | 

l-X--L-1 

If the symbolic parameter that 
corresponds to an omitted operand is used 
in a model statement, a null character 
value (not a blank) replaces the symbolic 
parameter in the generated statement, i.e., 
in effect the symbolic parameter is 
removed. 

For example, the first statement below 
is a model statement that contains the 
symbolic parameter £C. If the operand that 
corresponds to £C was omitted from the 
macro instruction, the second statement 
below would be generated ffom the model 
statement. 


W*NAME 

5A)B 

(15 B) 
•ONE' IS 


(odd number of apostrophes) 
(number of left parentheses 
does not equal number of 
right parentheses) 

(blank not placed between 
paired apostrophes) 

(blank not placed between 
paired apostrophes) 


r-*r-T- 

JName (Operation|Operand 

I--4- 4 - 

| |MVC |THERE£C.25,THIS 

j |MVC J THERE25,THIS 

L-1_x- 


1 


Operand Sublists 


Statement Form 


An operand of a macro instruction may be a 
sublist. 


Macro instructions may be written using the 
same alternate form that can be used to 
write prototype statements. If this form 
is used, a blank does not always indicate 
the end of the operand entry. The 


Sublists provide the programmer with a 
convenient way to refer to: (1) a 
collection of macro instruction operands as 
a single operand, or (2) a single operand 
in a collection of operands. 
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A sublist consists of one or more 

r - 

-- — 

~ T -- 

operands (subeperands) separated by commas 

(Name 

JOperation jOperand 

and enclosed in paired parentheses. The 

I-- 

-4 - 

“4 - 

entire sublist, including the parentheses. 

Header | 

jMACRO 

1 

is considered to be one macro instruction 

PrototypeJ 

JADDNUM 

| SNUM,SBEG,SABEA 

operand. 

Model j 

|L 

| SREG, SNUM ( 1) 


Model j 

|A 

j SREG , SNUM (2) 


Model 1 

|A 

j SREG , SNUM (3) 

A suboperand is always treated as a 

Model | 

|ST 

| SR EG , SAREA 

character string. It is not possible to 

Trailer j 

JMEND 

1 

pass a suboperand containing a sublist to 

1- 

*4 - 

.4- 

an inner macro instruction (a macro 

Macro j 

JADDNUM 

J (A,B,C) , 6 ,SUM 

instruction used as a model statement in a 

Generated j 

|L 

| 6 ,A 

macro definition). The inner macro would 

Generated j 

|A 

16 ,B 

regard the operand as a character string 

Generated j 

|A 

| 6 ,C 

during generation. 

Generated j 

JST 

|6 ,SUM 


Oiritted sufccperands are handled in the 
same way as emitted operands. If ( ) 
appears as an operand, however, it is 
treated as a character string, net as a 
sublist with all sutoperands omitted. 


If a macro instruction is written in the 
alternate statement format, each sublist 
operand may be written on a separate line; 
the macro instruction may be written on as 
many lines as there are operands, including 
sublist operands. 


The limit of 127 characters (255 for 
assembler F) applies to an entire sublist 
including suboperands, parentheses, and 
commas within these parentheses. 


If SP1 is a symbolic parameter in a 
prototype statement, and the corresponding 
operand of a macro instruction is a 
sublist, then SP1 (n) may be used in a model 
statement to refer to the nth operand of 
the sublist, where n may be any arithmetic 
expression allowed in a SETA instruction. 
The SETA instruction is described in 
Section 9. If SP1 is a symbolic parameter, 
and the corresponding operand of a macro 
instruction is a sublist, then 6 P 1 refers 
to the entire sublist (including 
parentheses). 


If the sublist notation is used, but the 
operand is not a sublist, then SF1 (1) 
refers to the operand and SP1 (2) through 
SP1 (100) (SP1 (200) for assembler F) refer 
to null character value. If an operand has 
the form ( ), it is treated as a character 
string and not as a sublist. 


For example, consider the following 
macro definition, macro instruction, and 
generated statements. 


Ihe operand of the macro instruction 
that corresponds to symbolic parameter SNUM 
is a sublist. One of the operands in the 
sublist is referred to in the operand entry 
cf three of the model statements. For 
example, SNUM (1) refers to the first 
operand in the sublist corresponding to 
symbolic parameter SNUM. The first operand 
of the sublist is A. Therefore, A replaces 
SNUM (1) to form part of the generated 
statement. 

Note : When referring to an operand in a 
sublist, the left parenthesis of the 
sublist notation must immediately follow 
the last character of the symbolic 
parameter, e.g., SNUM (1) . A period should 
net be placed between the left parenthesis 
and the last character of the symbolic 
parameter. 

A period may be used between these two 
characters only when the programmer wants 
to concatenate the left parenthesis with 
the characters that the symbolic parameter 
represents. The following example shows 
what would be generated if a period 
appeared between the left parenthesis and 
the last character of the symbolic 
parameter in the first model statement cf 
the above example. 


|Name 

1 

JOperation|Operand 
a 1 

r 

Prototype| 
Model | 

1 __ 

Iaddnum 

|L 

1 

j SNUM,6REG,SAREA 

J SREG , SNUM . (1) 

r 

Macro | 

Generated j 

L __ 

T 

JADDNUM 

|L 

.J_ 

1 

] (A,B,C) ,6,SUM 

16 , (A ,B ,C) (1) 

_X-_ 


The symbolic parameter SNUM is used in 
the operand entry of the model statement. 
The characters (A,B,C) of the macro 
instruction correspond to SNUM. Since SNUM 
is immediately followed by a period, SNUM 
and the period are replaced by (A,E,C). 

The period does not appear in the generated 
statement. The resulting generated 


Section 8 : How to Write Macro Instructions 81 











statement is an invalid assembler language 
statement. 


Inner Macro Instructions 


A macro instruction may be used as a model 
statement in a macro definition. Macro 
instructions used as model statements are 
called inner macro instructions. 


A macro instruction that is not used as 
model statement is referred to as an 


r- t- t - — — — 

(Name JOperation{Operand 

L ± 

r 

Header | 

t 

{MACRO 

T 

1 

Prototype j 

j COMP 

j 6R 1 , SR2 , SS , ST , SU 

Model | 

| SR 

| SR 1 , 6R2 

Model { 

|C 

j SRI , ST 

Model j 

j ENE 

j 6U 

1 

Inner | 

j- 

{ADDNUM 

-4 1 

j SS , 12 , ST I 

i 

j- 

“+-— 1 

Model |SU {A 

j SR 1 , ST 

Trailer | 

{MEND 

1 

1 

1 

jMACRO 
jADDNUM 

1 

|SNUM,SREG,SAREA 


cuter macro instruction. 


1 

{MEND 

1 



1 - 

— — — — —— - 

- -4 - 



Outer |K 

j COMP 

{10,11, (X,Y,Z) ,J,K 

Any symbolic parameters used in an 

inner 

h- 

-~4- 

-4- 

macro instruction are replaced by the 


Generated| 

| SR 

{ 10,11 

corresponding operands of the outer macro 

Generated j 

|C 

J 10 ,J 

instruction. 


Generated j 

J BNE 

IK 



1 

Generated{ 

I-— 

|L 

{ 12 ,X | 

The macro definition corresponding 

to an 

Generated j 

|A 

|12,Y | 

inner macro instruction is used to generate 

Generated j 

|A 

1 12, Z { 

the statements that replace the inner 

macro 

Generated j 

j ST 

J 12 ,J | 

instruction. 


1 

{- 

-.}.-j 



Generated |K 

|A 

1 10 ,J 


L 

A 

A 

ST 


SREG , SNUM (1) 
SREG , SNUM (2) 
SREG , SNUM (3) 
SREG , SAREA 


The ADDNUM macro instruction of the 
previous example is used as an inner macro 
instruction in the following example. 


The inner macro instruction contains two 
symbolic parameters, SS and ST. The 
characters (X,Y,Z) and J of the macro 
instruction correspond to SS and ST, 
respectively. Therefore, these characters 
replace the symbolic parameters in the 
operand entry of the inner macro 
instruction. 


Note : An ampersand that is part of a 

symbolic parameter is not considered in 
determining whether a macro instruction 
operand contains an even number of 
consecutive ampersands. 


Levels of Macro Instructions 


The assembler then uses the macro 
definition that corresponds to the inner 
macro instruction to generate statements to 
replace the inner macro instruction. The 
fourth through seventh generated statements 
have been generated for the inner macro 
instruction. 


A macro definition that corresponds to an 
outer macro instruction may contain any 
number of inner macro instructions. The 
outer macro instruction is called a first 
level macro instruction. Each of the inner 
macro instructions is called as second 
level macro instruction. 

The macro definition that corresponds to 
a second level macro instruction may 
contain any number of inner macro 
instructions. These macro instructions are 
called third level macro instructions, etc. 

The number of levels of macro 
instructions that may be used depends upon 
the complexity of the macro definition and 
the amount of storage available. This is 
described in detail in Appendix E. 
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Section 9. How to Write Conditional Assembly Instructions 


The conditional assembly instructions allow 
the programmer to: (1) define and assign 
values to SET symbols that can be used to 
vary parts of generated statements, and (2) 
vary the sequence of generated statements. 
Thus, the programmer can use these 
instructions to generate many different 
sequences of statements from the same macro 
definition. 

There are 13 conditional assembly 
instructions, 10 of which are described in 
this section. The other three conditional 
assembly instructions—GBLA, GBLB, and 
GBLC—are described in Section 10. The 
instructions described in this section are: 

LCLA SETA AIF ANOP 

LCLB SETB AGO 

LCLC SETC ACTR 

The primary use of the conditional 
assembly instructions is in macro 
definitions. However, all of them may be 
used in an assembler language source 
program. 

Where the use of an instruction outside 
macro definitions differs from its use 
within macro definitions, the difference is 
described in the subsequent text. 

The LCLA, LCLB, and LCLC instructions 
are used to define and assign initial 
values to local SET symbols. 

The SETA, SETB, and SETC instructions 
may be used to assign arithmetic, binary, 
and character values, respectively, to SET 
symbols. The SETB instruction is described 
after the SETA and SETC instructions, 
because the operand of the SETB instruction 
is a combination of the operands of the 
SETA and SETC instructions. 

The AIF, AGO, and ANOP instructions may 
be used in conjunction with sequence 
symbols to vary the sequence in which 
statements are assembled. The programmer 
can test attributes assigned by the 
assembler to symbols or macro instruction 
operands to determine which statements are 
to be processed. The ACTR instruction may 
be used to limit the number of AIF and AGO 
branches executed in any assembly. 

Examples illustrating the use of 
conditional assembly instructions are 
included throughout this section. A chart 
summarizing the elements that can be used 
in each instruction appears at the end of 
this section. 


SET Symbols 


SET symbols are one type of variable 
symbol. The symbolic parameters discussed 
in Section 7 are another type of variable 
symbol. SET symbols differ from symbolic 
parameters in three ways: (1) where they 
can be used in an assembler language source 
program, (2) how they are assigned values, 
and (3) how the values assigned to them can 
be changed. 

Symbolic parameters can only be used in 
macro definitions, whereas SET symbols can 
be used inside and outside macro 
definitions. 

SET symbols are assigned values by SETA, 
SETB, and SETC conditional assembly 
instructions and by local or global 
declarations. 

Each symbolic parameter is assigned a 
single value for one use of a macro 
definition, whereas the values assigned to 
each SETA, SETB, and SeTC symbol are not so 
restricted. 


DEFINING SET SYMBOLS 


SET symbols must be defined by the 
programmer before they are used. When a 
SET symbol is defined it is assigned an 
initial value. SET symbols may be assigned 
new values by means of the SETA, SETB, and 
SETC instructions. A SET symbol is defined 
when it appears as an operand of an LCLA, 
LCLB, or LCLC instruction. 


USING VARIABLE SYMBOLS 


The SETA, SETB, and SETC instructions may 
be used to change the values assigned to 
SETA, SETB, and SETC symbols, respectively. 
When a SET symbol appears in the name of 
operand entry of a statement, the current 
value of the SET symbol (i.e., the last 
value assigned to it) replaces the SET 
symbol in the statement, when a SETC 
symbol appears in the operation entry of a 
statement, the current value of the SETC 
symbol replaces the Set symbol in the 
statement. 
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For example, if SA is a symbolic 
parameter, and the corresponding characters 
of the macro instruction are the symbol 
HERE, then HERE replaces each occurrence of 
SA in the macro definition. However, if SA 
is a SET symbol, the value assigned to SA 
can be changed, and a different value can 
replace various occurrences of SA in the 
macro definition. 

The same variable symbol may not be used 
as a symbolic parameter and as a SET symbol 
in the same macro definition. 

The following illustrates this rule. 


jName jOperationjOperand 

F-+-f- 

j 6NAME |MOVE |STO,SFROM 

L-J.-A.- 


is used in the operand entry of a macro 
instruction, and the value assigned to the 
SET symbol is in the form of sublist 
notation, the operand is not considered a 
sublist. 


Attributes 


The assembler assigns attributes to macro 
instruction operands and to symbols in the 
program. These attributes may be referred 
to only in conditional assembly 
instructions. 

■j There are six kinds of attributes. They 

| are: type, length, scaling, integer, 

J count, and number. 


If the statement above is a prototype 
statement, then 6NAME, STO, and SFROM may 
not be used as SET symbols in the macro 
definition. 

The same variable symbol may not be used 
as two different types of SET symbols in 
the same macro definition. Similarly, the 
same variable symbol may not be used as two 
different types of SET symbols outside 
macro definitions. 

For example, if SA is a SETA symbol in a 
macro definition, it cannot be used as a 
SETC symbol in that definition. Similarly, 
if SA is a SETA symbol outside macro 
definitions, it cannot be used as a SETC 
symbol outside macro definitions. 


If an outer macro instruction operand is 
a symbol before substitution, then the 
attributes of the operand are the same as 
the corresponding attributes of the symbol. 
The symbol must appear in the name entry of 
an assembler language statement or be an 
external symbol. The statement must be 
outside macro definitions and must not 
contain any variable symbols. 

If an inner macro instruction operand is 
a symbolic parameter, then attributes of 
the operand are the same as the attributes 
of the corresponding outer macro 
instruction operand. 

Each attribute has a notation associated 
with it. The notations are: 


The same variable symbol if declared 
local may be used in two or more macro 
definitions and outside macro definitions. 
If such is the case, the variable symbol 
will be considered a different variable 
symbol each time it is used. 

For example, if SA is a variable symbol 
(either SET symbol or symbolic parameter) 
in one macro definition, it can be used as 
a variable symbol (either SET symbol or 
symbolic parameter) in another definition. 
Similarly, if SA is a variable symbol (SET 
symbol or symbolic parameter) in a macro 
definition, it can be used as a SET symbol 
outside macro definitions. 


Attribute 

Type 

Length 

Scaling 

Integer 

Count 

Number 


Notation 

T* 

L' 

S' 

I* 

K* 

N* 


If a macro instruction operand is a 
sublist, the programmer may refer to the 
attributes of either the sublist or each 
operand in the sublist. The type, length, 
scaling, and integer attributes of a 
sublist are the same as the corresponding 
attributes of the first operand in the 
sublist. 


All variable symbols may be concatenated 
with other characters in the same way as 
symbolic parameters. The rules for 
concatenation are in Section 7 under the 
subsection "Model Statements." 

Variable symbols in macro instructions 
are replaced by the values assigned to 
them, immediately prior to the start of 
processing the definition. If a SET symbol 


All the attributes of macro instruction 
operands may be referred to in conditional 
assembly instructions within macro 
definitions. However, only the type, 
length, scaling, and integer attributes of 
symbols may be referred to in conditional 
assembly instructions outside macro 
definitions. Symbols appearing in the name 
entry of generated statements are not 
assigned attributes. 
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The programmer may refer to an attribute 
in the following ways: 

1. In a statement that is outside macro 
definitions, he may write the notation 
for the attribute immediately followed 
by a symbol. (E.g., T*NAME refers to 
the type attribute of the symbol 
NAME.) 

2. In a statement that is in a macro 
definition, he may write the notation 
for the attribute immediately followed 
by a symbolic parameter. (E.g., L* 

6 NAME refers to the length attribute 
of the characters in the macro 
instruction that correspond to 
symbolic parameter SNAME; L' SNAME(2) 
refers to the length attribute of the 
second operand in the sublist that 
corresponds to symbolic parameter 
SNAME.) 


TYPE ATTRIBUTE (T*) 


The type attribute of a macro instruction 
operand or a symbol is a letter. 

The programmer may refer to a type 
attribute in the operand of a SETC 
instruction, or in character relations in 
the operands of SETB or AIF instruction, or 
in other instructions where use of the 
character is valid. 

The following letters are used for 
symbols that name DC and DS statements and 
for outer macro instruction operands that 
are symbols that name DC or DS statements. 

A A-type address constant, implied 

length, aligned. 

B Binary constant. 

C Character constant. 

D Long floating-point constant, 

implied length, aligned. 

E Short floating-point constant, 

implied length, aligned. 

F Fullword fixed-point constant, 

implied length, aligned. 

G Fixed-point constant, explicit 

length. 

H Halfword fixed-point constant, 

implied length, aligned. 

K Floating-point constant, explicit 

length. 

L Extended floating-point constant, 

implied length, aligned. 

P Packed decimal constant. 

R A-, S-, V-, or Y-type address 

constant, explicit length. 

S S-type address constant, implied 

length, aligned. 

V V-type address constant, implied 

length, aligned. 


X Hexadecimal constant. 

Y Y-type address constant, implied 

length, aligned. 

Z Zoned decimal constant. 

The following letters are used for 
symbols (and outer macro instruction 
operands that are symbols) that name 
statements other than DC or DS statements, 
or that appear in the operand field of an 
EXTRN or WXTRN statement. 

I Machine instruction 

J Control section name 

M Macro instruction 

T EXTRN symbol 

W CCW instruction 

$ WXTRN symbol 

The following letters are used for inner 
and outer macro instruction operands only. 

N Self-defining term 

0 Omitted operand 

The letter U (Undefined) is used for 
inner and outer macro-instruction operands 
that cannot be assigned any of the above 
letters. The type attribute of all 
literals appearing as macro instruction 
operands is U. This also is true for inner 
macro instruction operands that are 
ordinary symbols or variable symbols. 
Because the attributes are not available at 
the necessary time, this letter is also 
assigned to symbols that name EQU and LTORG 
statements, to any symbols occurring more 
than once in the name entry of source 
statements, and to all symbols naming DC 
and DS statements with expressions or 
variable symbols as modifiers. The type 
attribute also is undefined when the 
modifier expression consists solely of 
self-defining terms. 

The attributes of A, B, C, and D in the 
following examples are undefined: 


A 

DC 

3FL (A-B) ' 15 

B 

DC 

(A-B) F' 15* 

C 

DC 

SX* 1* 

D 

DC 

FL (3-2) *1' 


LENGTH (L‘) , SCALING (S 1 ) , AND INTEGER 


ATTRIBUTES 


The length, scaling, and integer attributes 
of macro instruction operands and symbols 
are numeric values. 

The length attribute of a symbol (or of 
a macro instruction operand that is a 
symbol) is as described in Part 1 of this 
publication. Reference to the length 
attribute of a variable symbol is illegal 
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except for symbolic parameters in SETA, 
SETB, and AIF statements. If the basic L* 
attribute is desired, it can be obtained as 
follows: 

6 A SETC 'Z' 

SB SETC *L*'' 

MVC SA. (SBSA) ,X 

After generation, this would result in 
MVC Z (L*Z) ,X 

Reference must not be made to the length 
attributes of symbols or macro instruction 
operands whose type attributes are the 
letters M, n, 0, T, $, or U. 

Scaling and integer attributes are 
provided for symbols that name fixed-point, 
floating-point, and decimal DC or DS 
statements. 

Fixed and Floating Point . The scaling 
attribute of a fixed point or floating 
point number is the value given by the 
scale modifier. The integer attribute is a 
function of the scale and length attributes 
of the number. 


the variable symbols, are used to determine 
the count attribute. 

The programmer may refer to the count 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETB and AIF 
instructions that are part of a macro 
definition. 


NUMBER ATTRIBUTE (N') 


The programmer may refer to the number 
attribute of macro instruction operands 
only. 

The number attribute is a value equal to 
the number of operands in an operand 
sublist. The number of operands in an 
operand sublist is equal to one plus the 
number of commas that indicate the end of 
an operand in the sublist. 

The following examples illustrate this 
rule. 


Decimal . The scaling attribute of a digits 
to the right of the decimal point. The 
integer attribute of a decimal number is 
the number of decimal digits to the left of 
the decimal point- 

Scaling and integer attributes are 
available for symbols and macro instruction 
operands only if their type attributes are 
H, F, and G (fixed point); D, E# K, and L 
(floating point) ; or P and Z (decimal) . 


(A, B, C, D, E) 
(A, , C, D, E) 
(A, B,C,D) 
(,B,C,D,E) 
(A,B,C,D,) 

(A , B, t, D , ,) 


5 operands 
5 operands 

4 operands 

5 operands 

5 operands 

6 operands 


If the macro instruction operand is not 
a sublist, the number attribute is one. If 
the macro instruction operand is omitted, 
the number attribute is zero. 


The programmer may refer to the length, 
scaling, and integer attributes in the 
operand field of a SETA instruction, or in 
arithmetic relations in the operand fields 
of SETB or AIF instructions. 


The programmer may refer to the number 
attribute in the operand field of a SETA 
instruction, or in arithmetic relations in 
the operand fields of SETE and AIF 
instructions that are part of a macro 
definition. 


COUNT ATTRIBUTE (K') 


The programmer may refer to the count 
attribute of macro instruction operands 
only. 

The count attribute is a value equal to 
the number of characters in the macro 
instruction operand after substituting for 
variable symbols, excluding commas. If the 
operand is a sublist, the count attribute 
includes the beginning and ending 
parentheses and the commas within the 
sublist. The count attribute of an omitted 
operand is zero. 

If a macro instruction operand contains 
variable symbols, the characters that 
replace the variable symbols, rather than 


ASSIGNING INTEGER ATTRIBUTES TO SYMBOLS 


The integer attribute is computed from the 
length and scaling attributes. 

Fixed Point . The integer attribute of a 
fixed-point number is equal to eight times 
the length attribute of the number minus 
the scaling attribute minus one; i.e., 
I'=8*L'-S'-1. 

Each of the following statements defines 
a fixed-point field. The length attribute 
of HALFCON is 2, the scaling attribute is 
6 , and the integer attribute is 9. The 
length attribute of 0NEC0N is 4, the 
scaling attribute is 8, and the integer 
attribute is 23. 
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r - T -r- 1 

(Name |Operation|Operand | 


j HALFCON j DC |HS6'-25.93' j 

jONECON |DC |FS 8 '100.3E-2* j 

L_J.-J.-J 


Floating Point : The integer attribute of a 
type D or E floating-point number is equal 
to two times the difference between the 
length attribute of the number and one, 
minus the scaling attribute; i.e., 

I'-2* (L'-l)-s'. 

Because of its low order characteristic, 
the integer attribute of a type L constant 
with a length greater than 8 bytes is two 
less than the value indicated in the 
formula above. The integer attribute of a 
type L constant with a length of 8 bytes cr 
less is the same as the value indicated in 
the formula above. 


Sequence Symbols 


The name entry of a statement may contain a 
sequence symbol. Sequence symbols provide 
the programmer with the ability to vary the 
sequence in which statements are processed 
by the assembler. 


A sequence symbol is used in the operand 
entry of an AIF or AGO statement to refer 
to the statement named by the sequence 
symbol. 


A sequence symbol may be used in the 
name entry of any statement that does net 
contain a symbol or SET symbol, except a 
prototype statement, or a MACRO, LCLA, 
LCLB, LCLC, GBLA, GBIE, GELC, ACTR, ICTL, 
ISE£, or COPY instruction. 


Each of the following statements defines 
a floating-point value. The length 
attribute of SHORT is 4, the scaling 
attribute is 2 , and the integer attribute 
is 4. The length attribute of LONG is 8 , 
the scaling attribute is 5, and the integer 
attribute is 9. 

r- t -r- 

|Name |Operation|Operand 

I--+-f- 

j SHORT j DC j ES2'46.415' 

1L0NG j DC [dS5'-3.729* 

l-i_ L _ 


A sequence symbol consists of a period 
followed by one through seven letters 
and/cr digits, the first of which must be a 
letter. 


The following are valid sequence 
symbols: 


-j .READER . A23456 

j .LC0P2 .X4F2 

S .N . S4 


Decimal : The integer attribute of a packed 
decimal number is equal to two times the 
length attribute of the number minus the 
scaling attribute minus one; i.e., 
I'=2*L'-S'-1. The integer attribute of a 
zoned decimal number is equal to the 
difference between the length attribute and 
the scaling attribute; i.e., I'=L'-S'. 

Each of the following statements defines 
a decimal field. The length attribute of 
FIRST is 2, the scaling attribute is 2, and 
the integer attribute is 1. The length 
attribute of SECOND is 3, the scaling 
attribute is 0 , and the integer attribute 
is 3. The length attribute of THIRD is 4, 
the scaling attribute is 2 , and the integer 
attribute is 2. The length attribute of 
FOURTH is 3, the scaling attribute is 2, 
and the integer attribute is 3. 


r- T -r- 

| Name |Operation!Operand 


I-- 

-t- 

-f——-- 

| FIRST 

| DC 

|P'+1.25' 

j SECOND 

j DC 

|Z'-543' 

jTHIRD 

| DC 

|Z * 79. 68 ' 

| FOURTH 

j DC 

|P* 79.68' 

l__ 

.1 - 

_ L _ 


I 

I 

I 


The following are invalid sequence 
symbols: 


CARDAREA 
. 246B 
.AREA2456 
.ECDX84 

.IN AREA 


(first character is not a 
period) 

(first character after 
period is not a letter) 

(more than seven characters 
after period) 

(contains a special 
character other than initial 
period) 

(contains a special 
character, i.e., blank, 
other than initial period) 


If a sequence symbol appears in the name 
entry of a macro instruction, and the 
corresponding prototype statement contains 
a symbolic parameter in the name entry, the 
sequence symbol does not replace the 
symbolic parameter wherever it is used in 
the macro definition. 


The following example illustrates this 
rule. 
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r- T --—r- 

(Name | Operation| Operand 

j.-4-f- 

J |MACRO j 

1j SNAME j MOVE 


2|SNAME |ST 

I |L 

| |ST 

I |L 

j |MENE 

K 
4| 


| 6TO, SFROM 
| 2,SAVEAREA 
j 2,SFROM 
j 2, 6TO 
j 2,SAVEAREA 


-4- 

.SYM (MOVE 

_ _ i_ 

—4 - 

(FIELDA,FIELDB 

(ST 

|2,SAVEAREA 

|L 

j 2,FIELDB 

|ST 

j 2,FIELDA 

IL 

|2,SAVEAREA 

-X- 

_J_ 


The symbolic parameter SNAME is used in 
the name entry of the prototype statement 
(statement 1) and the first model statement 
(statement 2). In the macro instruction 
(statement 3) a sequence symbol (.SYM) 
corresponds to the symbolic parameter 
SNAME. SNAME is not replaced by .SYM, and, 
therefore, the generated statement 
(statement 4) does not contain a name 
entry. 


LOLA, LCLB, LCLC-Define SET Symbols 

The typical form of these instruction is: 


conditional assembly instructions, and 
punch and REFRC statements outside macro 
definitions, and before the first control 
section of the program. 


SETA-Set Arithmetic 


The SETA instruction may be used to assign 
an arithmetic value to a SETA symbol. The 
form of this instruction is: 

r - T - T - 1 

|Name (Operation(Operand f 

(.- 4 - 4 - 4 

jA SETA j SETA jA SETA arithmetic j 

jsymbol j (expression j 

l -x- l-J 

The expression in the operand entry is 
evaluated as a signed 32-bit arithmetic 
value which is assigned to the SETA symbol 
in the name entry. The minimum and maximum 
allowable values of the expression are -2 31 
-and +2 31 -1, respectively. 

The expression may consist of one term 
or an arithmetic combination of terms. The 
terms that may be used alone or in 
combination with each other are 
self-defining terms, variable symbols, and 
the length, scaling, integer, count, and 
number attributes. Self-defining terms are 
described in Part 1 of this publication. 


r - T -r- 1 

(Name |Oper ation(Operand | 

t - 4 - 4 - 4 

(Not used,(LOLA, (One or more variable ( 
(must not jLCLB, or |symbols, that are j 

(be (LCLC (to be used as SET j 

(present j (symbols, separated j 

(j (by commas j 

i-x-x_j 

The LCLA, LCLB, and LCLC instructions 
are used to define and assign initial 
values to SETA, SETB, and SETC symbols, 
respectively. The SETA, SETB, and SETC 
symbols are assigned the initial values of 
0, 0, and null character value, 
respectively. 

The programmer should not define any SET 
symbol whose first four characters are 
SSYS. 


Note : A SETC variable symbol may appear in 
a SETA expression only if the value of the 
SETC variable is one to eight decimal 
digits. The decimal digits will be 
converted to a positive arithmetic value. 

The arithmetic operators that may be 
used to combine the terms of an expression 
are + (addition) , - (subtraction) , * 
(multiplication) , and / (division) . 

An expression may not contain two terms 
or two operators in succession, nor may it 
begin with an operator. 

The following are valid operand fields 
of SETA instructions: 

6AREA+X*2D* I'SN/25 

SBETA*10 SEXIT-S* SENTRY+1 

L'SHERE+32 29 


All LCLA, LCLB, or LCLC instructions in 
a macro definition must appear immediately 
after the prototype statement and all GELA, 
GELE or GELC instructions. All LCLA, LCLB, 
or LCLC instructions outside macro 
definitions must appear after all macro 
definitions in the source program, after 
all GELA, GELE, and GELC instructions 
outside macro definitions, before all 


The following are invalid operand fields 
of SETA instructions: 


SAREAX'C' 

SFIELD+- 

-SDEITA+2 

*+32 

NAME/15 


(two terms in succession) 

(two operators in succession) 
(begins with an operator) 
(begins with an operator; 
two operators in succession) 
(NAME is not a valid term) 
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EVALUATION OF ARITHMETIC EXPRESSIONS 


Using SETA Symbol s 


The procedure used to evaluate the 
arithmetic expression in the operand of a 
SETA instruction is the same as that used 
to evaluate arithmetic expressions in 
assembler language statements. The only 
difference between the two types of 
arithmetic expressions is the terms that 
are allowed in each expression. 

The following evaluation procedure is 
used: 


The arithmetic value assigned to a SETA 
symbol is substituted for the SETA symbol 
when it is used in an arithmetic relation. 
If the SETA symbol is not used in an 
arithmetic expression, the arithmetic value 
is completely converted to an unsigned 
integer, with leading zeros removed. If 
the value is zero, it is converted to a 
single zero. 


The following example illustrates this 
rule: 


1. Each term is given its numerical 


value. 

r-- 

*T“ -- 


i 


(Name 

|Operation(Operand 

1 


F- 

"F- 

~4- 

--J 

2. The arithmetic operations are 

1 

(MACRO 

I 


performed moving from left to right. 

j 6NAME 

(MOVE 

j 6TC,6FROM 


However, multiplication and/or 

1 

(LCLA 

j 6A,6B,6C,6D 


division are performed before addition 

1 |6A 

| SETA 

110 


and subtraction. 

2 j SE 

(SETA 

112 



3 | 6C 

j SETA 

j 6A-6B 



4 jSE 

j SETA 

| 6A+ 6C 


3. The computed result is the value 

j 6NAME 

|ST 

j 2,SAVEAREA 


assigned to the SETA symbol in the 

51 

|L 

j 2 , SFRCM6C 


name entry. 

61 

|ST 

{2,6TC6D 



1 

|L 

|2,SAVEAREA 



1 

|MEND 

I 


The arithmetic expression in the operand 

F- 

4- 

—+- 

-< 

entry of a SETA instruction may contain one 

j HERE 

(MOVE 

j FIEIDA,FIELDB 


or more sequences of arithmetically 

F- 

4- 

—-F--- 

-.| 

combined terms that are enclosed in 

j HERE 

|ST 

j2,SAVEAREA 


parentheses. A sequence of parenthesized 

1 

(L 

|2,FIELDB2 


terms may appear within another 

1 

j ST 

|2,FIELDA8 


parenthesized sequence. 

1 

|L 

J2,SAVEAREA 



i_«_ l_J 


The following are examples of SETA 
instruction operands that contain 
parenthesized sequences of terms. 

(L* SHERE+32) *29 

6AREA+X* 2E*/ (6EXIT-S* SENTRY+ 1) 

6BETA*10* (I* 6/25/ (SEXIT-S* 6ENTRY+1) ) 

The parenthesized portion or portions of 
an arithmetic expression are evaluated 
before the rest of the terms in the 
expression are evaluated. If a sequence of 
parenthesized terms appears within another 
parenthesized sequence, the innermost 
sequence is evaluated first. 

The SETA arithmetic expression can only 
have five levels of parentheses. The 
parentheses required in subscripting, 
substring, and sublist notation count when 
determining these levels. A counter is 
maintained for each SETA statement and 
increased by one for each occurrence of a 
variable symbol as well as the operation 
entry. The maximum value this counter may 
attain is 35. (See Appendix H). 


Statements 1 and 2 assign to the SETA 
symbols 6A and 6B the arithmetic value +10 
and +12, respectively. Therefore, 
statement 3 assigns the SETA symbol 6C the 
arithmetic value -2. When 6C is used in 
statement 5, the arithmetic value -2 is 
converted to the unsigned integer 2. When 
6C is used in statement 4, however, the 
arithmetic value -2 is used. Therefore, 6E 
is assigned the arithmetic value +8. When 
6D is used in statement 6, the arithmetic 
value +8 is converted to the unsigned 
integer 8. 


Ihe following example shows how the 
value assigned to a SETA symbol may be 
changed in a macro definition. 
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1 


INarre 




"T- 1 - 

|Operation)Operand 


j MACRO 
SNAME j MOVE 
j LCLA 
SA |SETA 
SNAME |ST 
|L 

SA |SETA 
j ST 
|L 

j MEND 

HERE |MOVE 

-+- 

HERE j ST 
|L 
| ST 
|L 

-JL- 


STO,SFROM 

SA 

5 

2,SAVEAREA 
2,SFROMSA 
8 

2,STOSA 
2,SAVEAREA 


FIELDA,FIELDB 


2,SAVEAREA 
2,FIELDB5 
2 ,FlELDA8 
2,SAVEAREA 


Statement 1 assigns the arithmetic value 
+5 to SETA symbol SA. In statement 2, SA 
is converted to the unsigned integer 5. 
Statement 3 assigns the arithmetic value +8 
to SA. In statement 4, therefore, SA is 
converted to the unsigned integer 8, 
instead of 5. 


r-r- t- 

j Name j Cperation|Operand 


I-- 

I 

1 ! 

I 

2]SIAST 

I 

31 
I 


|MACRO 
j ADDX 
j LCLA 
j SETA 

|L 
|A 
1ST 
| MEND 


SNUMEER,SPEC 
SLAST 
N* SNUMEER 
SPEG, SNUMEER (1) 
SREG,SNUMEER (SLAST) 
6REG, SNUMEER (1) 


lADEX 


(A ,B ,C ,D,E) ,3 


11 * 
|A 
1ST 


3 , A 
3 ,E 
3 ,A 


A 

I 

A 


SNUMEER is the first symbolic parameter 
in the operand entry of the prototype 
statement (statement 1). The corresponding 
characters, (A,E,C,D,E) , of the macro 
instruction (statement 4) are a sublist. 
Statement 2 assigns to SLAST the arithmetic 
value +5, which is equal to the number of 
operands in the sublist. Therefore, in 
statement 3, SNUMBER (SLAST) is replaced by 
the fifth operand of the sublist. 


A SETA symbol may be used with a 
symbolic parameter to refer to an operand 
in an operand sublist. If a SETA symbol is 
used for this purpose it must have been 
assigned a value in the range 1 to 100. 


Any expression that may be used in the 
operand of a SETA instruction may be used 
to refer to an operand in an operand 
sublist. 


Sublists are described in Section 8 
under "Operand Sublists." 


The following macro definition may be 
used to add the last operand in an operand 
sublist to the first operand in an operand 
sublist and store the result at the first 
operand. A sample macro instruction and 
generated statements follow the macro 
definition. 


SETC- Set Character 


The SETC instruction is used to assign a 
character value to a SETC symbol. The form 
cf this instruction is: 

r-T- t-1 

|Name |Operation|Operand | 

t -+- 4 - 4 

j A SETC |SETC jCne operand, cf j 

jsymbol j jthe form described j 

| | |below | 

i- x - x -j 

The operand may consist of the type 
attribute, a character expression, a 
substring notation, or a concatenation of 
substring notations and character 
expressions. A SETA symbol may appear in 
the operand of a SETC statement. The 
result is the character representation of 
the decimal value, unsigned, with leading 
zercs removed. If the value is zero, one 
decimal zero is used. 


TYPE ATTRIBUTE 


The character value assigned to a SETC 
symbol may be a type attribute. If the 
type attribute is used, it must appear 
alcne in the operand field. The following 
example assigns to the SETC symbol 6TYPE 
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1 


the letter that is the type attribute of 
the macro instruction operand that 
corresponds to the symbolic parameter SAEC. 


-T---T--- 

Name |Operation|Operand 

i ..i - _ 


t — — t 

STYPE J SETC |T'SABC 

X --J.--- 



CHARACTER EXPRESSION 


A character expression consists of any 
combination of characters enclosed in 
apostrophes. The maximum length of a 
character expression is 127 characters. 

The character value enclosed in 
apostrophes in the operand field is 
assigned to the SETC symbol in the name 
entry. The maximum length character value 
that can be assigned to a SETC symbol is 
eight characters. If a value greater than 
8 is specified, the leftmost 8 characters 
will be used. 


EVALUATION OF CHARACTER EXPRESSIONS : The 
following statement assigns the character 
value AB%4 to the SETC symbol 6ALPHA: 

r- t-t-1 

|Name |Operation|Operand { 

I--+-+- 1 

I SALPHA j SETC |'AB%4' | 

L----L_J_J 

More than one character expression may 
be concatenated into a single character 
expression by placing a period between the 
terminating apostrophe of one character 
expression and the opening apostrophe of 
the next character expression. For 
example, either of the following statements 
be used to assign the character value 
ABCDEF to the SETC symbol SBETA. 


Name 

(Operation|Operand 

X X 

SBETA 

T 

(SETC 

T 

j'ABCDEF' 

SBETA 

(SETC 

j'ABC'.'DEF' 


-L 

- X --- - _ . 


Two apostrophes must be used to 
represent a apostrophe that is part of a 
character expression. 

The following statement assigns the 
character value L*SYMBOL to the SETC symbol 
6LENGTH. 


r- t-t- 

(Name (Operation{Operand 

F- i -+- 

j 6LENGTH J SETC |'L" SYMBOL' 




I 

.j 


Variable symbols may be concatenated 
with other characters in the operand field 
of a SETC instruction according to the 
general rules for concatenating variable 
symbols with other characters (see Section 
7) - 


If SALPHA has been assigned the 
character value AE%4, either of the 
following statements may be used to assign 
the character value ABJ4RST to the variable 
symbol SGAMMA. 

C-T-T-1 

|Name (Operation(Operand | 

|-4-4- -1 

(SGAMMA (SETC j'SALPHA.RST' j 

i-a- x -j 


r- t-t- 1 

|Name (Operation(Operand ( 

I-4-4- \ 

j €DELTA (SETC j'SALPHARST' | 

l- X -1-j 

Two ampersands must be used to represent 
an ampersand that is not part of a variable 
symbol. Both ampersands become part of the 
character value assigned to the SETC 
symbol. They are not replaced by a single 
ampersand . 

The following statement assigns the 
character value HALFSS to the SETC symbol 
SAND. 


r- t-t- 

(Name (Operation(Operand 

F--F-+- 

j SAND (SETC j'HALFSS* 

L- X -J._ 


In this example. 


r - T - T - 

|Name (Operation(Operand 

F--F-+- 

|SA |SETC ('SSBETA' (2,5) 

L- X -Jl- 

'SSBETA' (2,5) produces SEETA which is 
considered a character string, not a 
variable symbol. 


I 

\ 

I 

j 


I 

-I 

I 

j 


SUBSTRING NOTATION 


The character value assigned to a SETC 
symbol may be a substring character value. 
Substring character values permit the 
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programmer to assign part of a character 
value to a SETC symbol. 


If the programmer wants to assign part 
of a character value to a SETC symbol, he 
must indicate to the assembler in the 
operand of a SETC instruction: (1) the 
character value itself, and (2) the part of 
the character value he wants to assign to 
the SETC symbol. The concatenation of (1) 


instruction is called a substring notation. 
The character value that is assigned to the 
SETC symbol in the name entry is called a 
substring character value. 


Substring notation consists of a 
character expression, immediately followed 
by two arithmetic expressions that are 
separated from each other by a comma and 
are enclosed in parentheses. These 
parentheses count when determining the 
number of levels of parentheses. The two 
arithmetic expressions may be any 
expression that is allowed in the operand 
of a SETA instruction. They may not be 
zero. 


The first expression indicates the first 
character (in the character expression) 
that is to be assigned to the SETC symbol 
in the name entry. The second expression 
indicates the number of consecutive 
characters in the character expression 
(starting with the character indicated by 
the first expression) that are tc be 
assigned to the SETC symbol. If a 
substring specifies more characters than 
are in the character string, only the 
number of available characters will be 
supplied. If the first expression 
specifies a larger number than the number 
of characters in the character expression, 
a null string will be the result. 


'BETA*4,6 

(arithmetic expressions not enclosed in 
parentheses) 

' 6ALPHA* (2,4) (1,1) 

(double substring notation is not 
permitted) 


CONCATENATING SUBSTRING N OTAT IONS AND 
CHARACTER EXPRESSIONS : Substring notations 
may be concatenated with character 
expressions in the operand of a SETC 
instruction. If a substring notation 
follows a character expression, the two may 
be concatenated by placing a period between 
the terminating apostrophe of the character 
expression and the opening apostrophe of 
the substring notation. 


For example, if SALFHA has been assigned 
the character value AEX4, and SEETA has 
been assigned the character value AECEEF, 
then the following statement assigns SGAMMA. 
the character value AEX4ECE. 


r- t-t-1 

|Name (Operation|Cperand j 

I--4-4-1 

j 6GAMMA j SETC j ' SALFHA' .* 6BETA' (2,3) j 

L-X-L-J 

If a substring notation precedes a 

character expression or another substring 
notation, the two may be concatenated by 
writing the opening apostrophe of the 
second item immediately after the closing 
parenthesis of the substring notation. 

The programmer may optionally place a 
period between the closing parenthesis of a 
substring notation and the opening 
apostrophe of the next item in the operand. 


The maximum size character expression 
the substring character value can be chosen 
from is 127 characters. 

The following are valid substring 
notations: 

'SALPHA' (2,5) 

*AB% 4 ' (SAREA + 2,1) 

' SALPHA ' . 'RST * (6 , SA) 

'ABC SGAMMA' (SA,SAREA+2) 

The following are invalid substring 
notations: 

' SEETA' (4,6) 

(blanks between character value and 
arithmetic expressions) 

'L " SYMBOL' (142-SXYZ) 

(only one arithmetic expression) 

'AE%4 SALPHA' (8 SFIELE*2) 

(arithmetic expressions not separated by 
a c cmma) 


If SALPHA has been assigned the 
character value AE%4, and SAEC has been 
assigned the character value 5RS, either of 
the following statements may be used to 
assign SWORE the character value AB%45RS. 

r- t-t-1 

|Name (Operation|Operand | 

I--4-4-^ 

jSWOREjSETC j'SAIPHA* (1,4)'SABC* j 

(SWORE (SETC j'SAIPHA* (1 ,4) ' SABC* (1,3) ( 

L- X -1-J 

If a SETC symbol is used in the operand 
of a SETA instruction, the character value 
assigned to the SETC symbol must be one to 
eight decimal digits. 

If a SETA symbol is used in the operand 
of a SETC statement, the arithmetic value 
is converted to an unsigned integer with 
leading zeros removed. If the value is 
zero, it is converted to a single zero. 
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The character value assigned to a SETC 
symbol is substituted for the SETC symbol 
when it is used in the name, operation, or 
operand of a statement. 

For example, consider the following 
macro definition, macro instruction, and 
generated statements. 


1 

2 

3 


Statement 1 assigns the character value 
FIELD to the SETC symbol SPREFIX. In 
statements 2 and 3, SPREFIX is replaced by 
FIELD. 

The following example shows how the 
value assigned to a SETC symbol may be 
changed in a macro definition. 


1 

2 

3 

4 


Statement 1 assigns the character value 
FIELD to the SETC symbol SPREFIX. 
Therefore, SPREFIX is replaced by FIELD in 
statement 2. Statement 3 assigns the 


j Operation!Operand 

i-f- 

|MACRO | 


SNAME |MOVE 
| LCLC 
SPREFIXj SETC 
SNAME j ST 
|L 

PREFIX jSETC 
|ST 
11 * 

| MEND 


STO,SFROM 

SPREFIX 

'FIELD* 

2,SAVEAREA 

2,SPREFIXSFRCM 

•AREA* 

2,6PREFIXST0 
2,SAVEAREA 


HERE |MOVE 


2,SAVEAREA 
2,FIELDB 
2,AREAA 
2,SAVEAREA 


r -r-r- 

|Name |Operation!Operand 


jMACRO 

SNAME j MOVE 
j LCLC 
SPREFIX j SETC 
SNAME j ST 
I L 
| ST 
|L 

! MEND 


STO,SFROM 
SPREFIX 

•field* 

2,SAVEAREA 
2,SPREFIXSFROM 
2,SPREFIXSTO 
2,SAVEAREA 


HERE j MOVE 


2,SAVEAREA 
2,FIELDS 
2,FIELDA 
2,SAVEAREA 


character value AREA to SPREFIX. 

Therefore, SPREFIX is replaced by AREA, 
instead of FIELD, in statement 4. 

The following example illustrates the 
use of a substring notation as the operand 
field of a SETC instruction. 


1 

2 


r- t-t-1 

| Name JOperationJOperand J 


y 


i 

i 

i 

i 

Y 

I 

f 


-4--f- ] 

jMACRO | j 

SNAME jMOVE |STC,SFRCM j 

| LCLC | SFREFIX | 

SPREFIX|SETC |*STC*(1,5) | 

SNAME |ST j2,SAVEAREA j 

JL j2,SPREFIXSFRCM j 

j ST 12,STC J 

JL (2,SAVEAREA j 

|MEND J j 

- 4 - 4 -^ 

HERE jMOVE |FIELDA,B | 

-4-4- —| 

HERE j ST 12,SAVEAREA j 

JL J2,FIELDB j 

J ST J2,FIELDA j 

j L j2,SAVEAREA | 

-.- L -J.- J 


Statement 1 assigns the substring 
character value FIELD (the first five 
characters corresponding to symbolic 
parameter STC) to the SETC symbol SPREFIX. 
Therefore, FIELD replaces SPREFIX in 
statement 2. 


SETB-Set Binary 

The SETE instruction may be used tc assign 
the binary value 0 or 1 to a SETB symbol. 
The form of this instruction is: 


r -7-7- 

| Name | Operation|Operand J 

j-4-4--J 

JA SETB J SETB JA 0 or a 1,(0) or (1) | 

{symbol | jor a logical ex- j 

j | jpression enclosed in J 

J j Jparentheses j 


The operand may contain a 0 or a 1 cr a 
logical expression enclosed in parentheses 
(No explicit binary zeros or ones are 
allowed in parentheses other than in the 
form (0) or (1) .) A logical expression is 
evaluated to determine if it is true or 
false; the SETB symbol in the name entry is 
then assigned the binary value 1 or 0 
corresponding to true or false, 
respectively. 

Note : The parentheses enclosing a logical 

expression do not count towards the 
parenthesis level limit. 
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A logical expression consists of cne 
term or a logical combination of terirs. 

The terms that may be used alone or in 
combination with each other are arithmetic 
relations, character relations, and SETB 
symbols. The logical operators used to 
combine the terms of an expression are AND, 
OP, and NOT. 


A logical expression may not contain two 
terms in succession. A logical expression 
may contain two operators in succession 
only if the first operator is either AND cr 
OR and the second operator is NOT. A 
logical expression may begin with the 
operator NOT. It may not begin with the 
operators AND cr OR. 

An arithmetic relation consists of two 
arithmetic expressions connected by a 
relational operator. A character relation 
consists of two character strings connected 
by a relational operator. The relational 
operators are EQ (equal), NE (not equal), 

LT (less than) , GT (greater than) , LE (less 
than or equal), and GE (greater than cr 
equal). 

Any expression that may be used in the 
operand of a SETA instruction, may be used 
as an arithmetic expression in the operand 
of a SETB instruction. Anything that may 
be used in the operand of a SETC 
instruction, may be used as a character 
string in the operand of a SETB 
instruction. This includes substring and 
type attribute notations. The maximum size 
of the character values that can be 
compared is 127 characters. If the two 
character values are of unequal length, 
then the shorter cne will always compare 
less than the longer one, regardless of the 
characters present. 

The relational and logical operators 
must be immediately preceded and followed 
by at least one blank or other special 
character. Each relation may or may not be 
enclosed in parentheses. If a relation is 
not enclosed in parentheses, it must be 
separated from the logical operators by at 
least one blank or other special character. 

The following are valid operand fields 
of SETB instructions: 

1 

(SAREA+2 GT 29) 

('AB*4' EQ ' SALPHA*) 

(T'SABC NE TSXYZ) 

(T' 6P12 EQ 'E') 

(SAREA+2 GT 29 OR 6E) 

(NOT SB AND SAREA+X'2D' GT 29) 

(* SC' EQ' ME*) 

The following are invalid operand fields 
of SETE instructions: 


SE (net enclosed in parentheses) 

(T *SP12 EQ •F* SB) 

(two terms in succession) 

(*AB*4 * EQ 'ALPHA* NCT SE) 

(the NCT operator must be preceded by 
AND or OR) 

(AND T * SF12 EQ 'F') 

(expression begins with AND) 


Evaluation of logical Expressions 

The following procedure is used to evaluate 
a -Logical expression m the operand field 
of a SETB instruction: 


1. Each term (i.e., arithmetic relation, 
character relation, or SETE symbol) is 
evaluated and given its logical value 

(true or false) . 

2. The logical operations are performed 
moving from left to right. However, 
NOTs are performed before ANDs, and 
ANDs are performed before CFs. 

3. The computed result is the value 
assigned to the SETE symbol in the 
name field. 

The logical expression in the operand of 
a SETB instruction may contain one or more 
sequences of logically combined terms that 
are enclosed in parentheses. A sequence of 
parenthesized terms may appear within 
another parenthesized sequence. 

The following are examples of SETE 
instruction operands that contain 
parenthesized sequences of terms. 

(NOT (SB AND SAREA+X'2D' GT 29)) 

(SB AND (T' SF 12 EQ'F'CR SE) 

The parenthesized portion or portions of 
a logical expression are evaluated before 
the rest of the terms in the expression are 
evaluated. If a sequence of parenthesized 
terms appears within another parenthesized 
sequence, the innermost sequence is 
evaluated first. 

Logical expressions may have only five 
levels of parentheses. Subscripting, 
substring notation, and logical expression 
nesting count when determining the level of 
parentheses. The parentheses surrounding 
the SETB operand do not count. A counter 
is maintained for each statement and is 
increased by one for each occurrence of a 
variable symbol and an operation entry. 

The maximum value this counter may attain 
is 35. See Appendix H. 
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Using SITE Symbols 


AIF-Conditional Branch 


The logical value assigned to a SETE symbol 
is used for the SETE symbol appearing in 
the operand of an AIF instruction or 
another SETB instruction. 


The AIF instruction is used to alter 
conditionally the sequence in which source 
program statements are processed by the 
assembler. The typical form of this 
instruction is: 


If a SETB symbol is used in the operand 
of a SETA instruction, or in arithmetic 
relations in the operands of AIF and SETE 
instructions, the binary values 1 (true) 
and 0 (false) are converted to the 
arithmetic values +1 and +0, respectively. 


If a SETB symbol is used in the operand 
of a SETC instruction, in character 
relations in the operands of AIF and SETB 
instructions, or in any other statement, 
the binary values 1 (true) and 0 (false) , 
are converted to the character values 1 and 
0, respectively. 


The following example illustrates these 
rules. It is assumed that L'STO EQ 4 is 
true, and S'STO EQ 0 is false. 


r—- 

| Name 


~T -T- 

j Operation!Operand 


6 NAME 


SB1 
SB 2 
SA1 
SCI 
SNAME 


MACRO 

MOVE 

LCLA 

LCLB 

LCLC 

SETB 

SETB 

SETA 

SETC 

ST 

L 

ST 

L 

MEND 


STO,SFROM 
SA1 

SB 1, SB 2 
SCI 

(L'STO EQ 
(S'STO EQ 
SB 1 
* SB2' 

2,SAVEAREA 
2 , SFROM S A 1 
2 , STO SC 1 
2,SAVEAREA 


HERE 

HERE 


MOVE 


FIELDA,FIELDB 


ST 

L 

ST 

L 


2,SAVEAREA 
2,FIELDB1 
2,FIELDA0 
2,SAVEAREA 


Because the operand of statement 1 is 
true, SB1 is assigned the binary value 1. 
Therefore, the arithmetic value +1 is 
substituted for SE1 in statement 3. 

Eecause the operand of statement 2 is 
false, SB2 is assigned the binary value 0. 
Therefore, the character value 0 is 
substituted for 6E2 in statement 4. 


T-T- 

{Operation|Operand 


I Name 


F- 

|Sequence|AIF 
jsymbol j 
j or not | 
jused j 

I I 

i-1- 


H 


jA logical expression 
jenclosed in paren- 
|theses, immediately 
J followed by a 
Jsequence symbol 
.x - 


Any logical expression that may be used 
in the operand of a SETE instruction may be 
used in the operand of an AIF instruction. 
However, the forms 

AIF (0) , sequence symbol and 

AIF (1) , sequence symbol 

are invalid. The sequence symbol in the 
operand must immediately follow the closing 
parenthesis of the logical expression. AIF 
operand entries must not contain explicit 
zeros or ones. 

Note : The parentheses enclosing the 

logical expression do not count toward the 
level limit. 

The logical expression in the operand is 
evaluated to determine if it is true or 
false. If the expression is true, the 
statement named by the sequence symbol in 
the operand is the next statement processed 
by the assembler; however, sequence 
checking is not affected. If the 
expression is false, the next sequential 
statement is processed by the assembler. 

The statement named by the sequence 
symbol may precede or follow the AIF 
instruction. 

If an AIF instruction is in a macro 
definition, then the sequence symbol in the 
operand must appear in the name entry of a 
statement in the definition. If an AIF 
instruction appears outside macro 
definitions, then the sequence symbol in 
the operand must appear in the name entry 
of a statement outside macro definitions. 

The following are valid operands of AIF 
instructions: 

(SAREA+X*2D' GT 29) .READER 
(T‘ SP12 EQ 'F') .THERE 

The following are invalid operands of 
AIF instructions: 
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(T* SAEC NE T'SXYZ) (no sequence symbol) 
.X4F2(no logical expression) 

(T' SABC NE T* 6XYZ) .X4F2 (blanks between 
logical expression and sequence symbol) 

The following macro definition may be 
used to generate the statements needed to 
move a fullword fixed-point number from one 
storage area to another. The statements 
will be generated only if the type 
attribute of both storage areas is the 
letter F. 


r--- 1 -t-1 

(Name JOperationjCperand J 

j.-4-4- -1 

) Sequence ]AGO {A sequence symbol | 

| symbol orj j j 

jnot used j j | 

t-1-1_„___j 


The statement named by the sequence 
symbol in the operand is the next statement 
processed by the assembler. 


1 

2 

3 


4 


r -* - 
| Name 

1 Operation)Operand 

X X 

I - ”"* 

SN 

|MACRO 
j MOVE 

ST , SF 


j AIF 

(T* ST NE T'SF) .END 


1AIF 

(T'ST NE *F') . END 

SN 

1ST 

2,SAVEAREA 


|L 

2, SF 


|ST 

2, ST 


|L 

2,SAVEAREA 

.END 

|MEND 


L-- 

X - 



The statement named by the sequence 
symbol may precede or follow the AGO 
instruction. 

If an AGO instruction is part of a macro 
definition, then the sequence symbol in the 
operand must appear in the name entry of a 
statement that is in that definition. If 
an AGO instruction appears outside macro 
definitions, then the sequence symbol in 
the operand must appear in the name entry 
of a statement outside macro definitions. 


The logical expression in the operand of 
statement 1 has the value true if the type 
attributes of the two macro instruction 
operands are not equal. If the type 
attributes are equal, the expression has 
the logical value false. 

Therefore, if the type attributes are 
not equal, statement 4 (the statement named 
by the sequence symbol .END) is the next 
statement processed by the assembler. If 
the type attributes are equal, statement 2 
(the next sequential statement) is 
processed. 

The logical expression in the operand of 
statement 2 has the value true if the type 
attribute of the first macro instruction 
operand is not the letter F. If the type 
attribute is the letter F, the expression 
has the logical value false. 

Therefore, if the type attribute is net 
the letter F, statement 4 (the statement 
named by the sequence symbol .END) is the 
next statement processed by the assembler. 
If the type attribute is the letter F, 
statement 3 (the next sequential statement) 
is processed. 


The following example illustrates the 
use of the AGO instruction. 

r-m- t-t 


(Name 

t j 

Operation jOperand 
j. 

r _ 1 

1 

MACRO 

T 

1 

jSNAME 

MOVE 

j ST,SF 

1 ) 

AIF 

j (T* ST EQ * F*) .FIRST 

2 j 

AGO 

j .END 

3j.FIRST 

AIF 

j (T* ST NE T* SF) .END 

JSNAME 

ST 

|2,SAVEAREA 

1 

L 

|2,6F 

1 

ST 

1 2 , ST 

1 

L 

j 2,SAVEAREA 

4 j.END 

MEND 

I 


i- j._ x --- j 

Statement 1 is used to determine if the 
type attribute of the first macrc 
instruction operand is the letter F. If 
the type attribute is the letter F, 
statement 3 is the next statement processed 
by the assembler. If the type attribute is 
net the letter F, statement 2 is the next 
statement processed by the assembler. 

Statement 2 is used to indicate to the 
assembler that the next statement to be 
processed is statement 4 (the statement 
named by sequence symbol .END). 


AGO-Unconditional Branch 


The AGO instruction is used to 
unconditionally alter the sequence in which 
source program statements are processed by 
the assembler. The typical form of this 
instruction is: 


ACTR-Conditional Assembly Loop Counter 

The ACTR instruction is used to limit the 
number of AGO and AIF branches executed 
within a macro definition or within the 
main source program. 
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A separate ACTR statement may be used in 
each macro definition and in the main 
program. These counters are independent. 

The form of this instruction is: 

r - r -r- 

|Name | Operation!Operand 

f -f-i- 

jNot used, j ACTR I Any valid SETA 

(must not j jexpression 

jbe present j | 

L_X-X- 

This statement must immediately follow 

any global or local declarations, if any. 
This statement causes a counter to be set 
to the value in its operand. Each time an 
AGO cr AIF branch is executed, the counter 
is decremented by one. If the count is 
zero before decrementing, the assembler 
takes cne of two actions: 

1. If a macro definition is being 
processed, the processing of it and 
any macros above it in a nest is 
terminated, and the next statement in 
the main portion of the program is 
processed. 

2. If the main portion of the program is 
being processed, conditional assembly 
is terminated, and the portion of the 
program generated so far is assembled. 

If an ACTR statement is not given, the 
assumed value of the counter is 150 for the 
E assembler and 4096 for the F assembler. 


before the statement and then branch to the 
ANOP instruction. This has the same effect 
as branching to the statement immediately 
after the ANCF instruction. 

The following example illustrates the 
use of the ANOP instruction. 

"I r-r- t-1 

j |Name |Operation|Cperand j 


1 

| MACRO 

1 I 

jSNAME 

|MOVE 

j ST , SF j 

1 

|LCLC 

|STYPE j 

1 1 

| AIF 

| (T* ST E Q 'F') .FTYPE j 

2 j S TYPE 

(SETC 

1 'E* | 

3 j.FTYPE 

(ANOP 

1 i 

4JSNAME 

j STSTYPE 

J2,SAVEAREA 1 

1 

(LSTYPE 

1 2 , SF | 

1 

j STSTYPE 

J 2 ,ST J 

1 

JLSTYPE 

J2,SAVEAREA j 

! 

(MEND 

! 1 


l-J.-L-J 


Statement 1 is used to determine if the 
type attribute of the first macro 
instruction operand is the letter F. If 
the type attribute is not the letter F, 
statement 2 is the next statement processed 
by the assembler. If the type attribute is 
the letter F, statement 4 should be 
processed next. However, since there is a 
variable symbol {SNAKE) in the name field 
of statement 4, the required sequence 
symbol. (.FTYPE) cannot be placed in the 
name field. Therefore, an ANOP instruction 
(statement 3) must be placed before 
statement 4. 


ANOP-Assembly No-Operation 

The ANOP instruction facilitates 
conditional and unconditional branching to 
statements named by symbols or variable 
symbols. 

The typical form of this instruction is: 


Then, if the type attribute of the first 
operand is the letter F, the next statement 
processed by the assembler is the statement 
named by sequence symbol .FTYFE. The value 
of STYPE retains its initial null character 
value because the SETC instruction is not 
processed. Since .FTYPE names an ANOP 
instruction, the next statement processed 
by the assembler is statement 4, the 
statement following the ANOP instruction. 


r- t -r-1 

| Name |Operation!Operand J 


jSequencejANOP jNot used, must not j 

jsymbol j jbe present j 

i-x-x-j 

If the programmer wants to use an AIF or 
AGO instruction to branch to another 
statement, he must place a sequence symbol 
in the name entry of the statement to which 
he wants to branch. However, if the 
programmer has already entered a symbol cr 
variable symbol in the name entry of that 
statement, he cannot place a sequence 
symbol in the name entry. Instead, the 
programmer must place an ANOP instruction 


Conditional Assembly Elements 


The following chart summarizes the elements 
that can be used in each conditional 
assembly instruction. Each row in this 
chart indicates which elements can be used 
in a single conditional assembly 
instruction. Each column is used to 
indicate the conditional assembly 
instructions in which a particular element 
can be used. 

The intersection of a column and a row 
indicates whether an element can be used in 
an instruction, and if so, in what fields 
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of the instruction the element can be used. 
For example, the intersection of the first 
row and the first column of the chart 


indicates that symbolic parameters can be 
used in the operand field of SETA 
instructions. 


Variable Symbols 


S.P. 


SET Symbols 


SETA j SETB j SETC 


f-4-4-4- 4 - 4 -4--4-^ 


-Attributes— 


■T-T-T- r-T 

T' | L' | S' | 1' | F' | N' 


S.S. 


SETA 


N ,0 


C 3 


+-4- 4 - 4 -4- 4 -4-1 


SETB 


N ,0 


0 1 


0 2 


0 2 


C 2 


C 2 


C 2 


4 -4-4-4-4-4-4 


SETC 


N,0 


4- 4 - 4 - 4 - 4 - 4 - 4 -^ 


AIF 


0 « 


0 2 


O 2 


O 2 


C 2 


C 2 


N,C 


I--+-1-f-f-+-+-+-+- i -H-4- \ 


AGO 


N, 0 


f - 4 -4-4-4-4-4-4-4-4-4-4-< 


ANOP 


N 


j.-4-4-4-4-4-4-4-f-1--4-j--^ 

ACTR ] 0 |0 jO j 0 3 j j 0 j C j 0 j C j C j 

-J.-1-i.-J.- 


.X_x. 


1 Only in character relations 

2 Only in arithmetic relations 

3 Only if one to eight decimal digits 

Abbreviations 


N is Name L* is Length Attribute K* is Count Attribute 

0 is Operand S' is Scaling Attribute N* is Number Attribute 

S.P. is Symbolic 1' is Integer Attribute S.S. is Sequence Symbol 

Parameter 
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Section 10. Additional Features 


The additional features of the assembler 
language allow the programmer to: 


The following example illustrates the 
use of the MEXIT instruction. 


1. 

Terminate processing of a macro 

r 

T 

T~ “ - 


definition. 

|Name 

^Operation|Operand 



|.- 

-4 - 

—4 - 

2. 

Generate errcr messages. 

1 

|MACRO 

1 



|6NAME 

|MOVE 

j ST , SF 

3. 

Define global SET symbols. 

1 j 

| AIF 

j (T' ST EQ 



2 | 

|MEXIT 

1 

4. 

Define subscripted SET symbols. 

3 j OK 

j ANOP 

1 



j SNAME 

ST 

|2,SAVEAREA 

5. 

Use system variable symbols. 

1 

|L 

1 2 , SF 



1 

ST 

! 2 , ST 

6. 

Prepare keyword and mixed-mode macro 

1 

|L 

j 2,SAVEAREA 


definitions and write keyword and 

1 

|MEND 

1 


mixed-mode macro instructions. 

l 

—L- 

_-L_- _ _ 


MEXIT-Macio Definition Exit 


The MEXIT instruction is used to indicate 
to the assembler that it should terminate 
processing cf a macro definition. The 
typical form of this instruction is: 

r- t -r-1 

|Name |Operation!Operand | 

f---4-4-f 

|Sequence |MEXIT |Not used, J 

jsymbol orj jmust not be j 

jnot used | jpresent | 

L- J. - L -J 

The MEXIT instruction may only be used 
in a macro definition. 

If the assembler processes an MEXIT 
instruction that is in a macro definition 
corresponding to an outer macro 
instruction, the next statement processed 
by the assembler is the next statement 
outside macro definitions. 


Statement 1 is used to determine if the 
type attribute of the first macrc 
instruction operand is the letter E. If 
the type attribute is the letter F, the 
assembler processes the remainder cf the 
macro definition starting with statement 3. 
If the type attribute is not the letter F, 
the next statement processed by the 
assembler is statement 2. Statement 2 
indicates to the assembler that it is to 
terminate processing of the macrc 
definition. 


MNOTE Statement 


The MNOTE instruction may be used to 
generate a message and to indicate what 
errcr severity code, if any, is to be 
associated with the message. The severity 
code is for the programmer's information 
only and is not used by the DOS assembler 
or control program. The typical form of 
this instruction is: 


If the assembler processes an MEXIT 
instruction that is in a macro definition 
corresponding to a second or third level 
macro instruction, the next statement 
processed by the assembler is the next 
statement after the second or third level 
macro instruction in the macro definition, 
respectively. 

MEXIT should not be confused with MEND. 
MEND indicates the end of a macro 
definition. MEND must be the last 
statement of every macro definition, 
including those that contain one or more 
MEXIT instructions. 


r-7- T -, 

|Name JOperationJCperand | 

y -4-4- 1 

|Sequence |MNOTE |See examples below. J 
jsymbol orj j f 

jnot used j j | 

i_i- l-J 

The operand entry of the MNOTE assembler 
instruction may be written in one of the 
following forms: 

1. severity code, 'message* 

2. ,'message' 
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3. 


' message* 

For 2 and 3 above, the severity code is 
assumed to be one. 


The MNOTE instruction may only be used 
in a macro definition. Variable symbols 
may be used to generate the MNOTE mnemonic 
operation code, the severity code 
indicator, and the message. 

The resulting severity code indicator 
may be a decimal integer 0 to 255, blank, 
or an asterisk. The integers indicate the 
severity of the error. (0 is the least 
severe; 255 is the most severe). If the 
severity code indicator is blank or 
omitted, 1 is assumed. If the severity 
cede is an asterisk, the MNOTE is not 
considered an error message. Messages can 
be generated with substitution using 
variable symbols. 

The MNOTE statement appears in the 
listing with a statement number at the 
point where it was generated. It appears 
even if PRINT NOGEN is specified. If the 
severity code indicator was an integer or a 
blank, this statement number is placed in a 
list of statement numbers of MNOTE and 
other error statements near the end of the 
assembly listing. If the severity code is 
an asterisk, the statement number is not 
placed in this list. 


Statement 1 is used to determine if the 
type attributes of both macro instruction 
operands are the same. If they are, 
statement 2 is the next statement processed 
by the assembler. If they are not, 
statement 5 is the next statement processed 
by the assembler. Statement 5 causes an 
error message—8,TYPE NOT SAME—to be 
printed in the source program listing. 

Statement 2 is used to determine if the 
type attribute of the first macro 
instruction operand is the letter F. If 
the type attribute is the letter F, 
statement 3 is the next statement processed 
by the assembler. If the attribute is not 
the letter F, statement 6 is the next 
statement processed by the assembler. 
Statement 6 causes an error message—8,TYPE 
NOT F—to be printed in the source program 
listing. Statement 4 is an MNOTE which is 
net treated as an error message. 


Global and Local Variable Symbols 


The following are local variable symbols: 

1. Symbolic parameters. 

2. Local SET symbols. 

3. System variable symbols. 

Global SET symbols are the only global 
variable symbols. 


Since the message portion of the MNOTE 
operand is enclosed in apostrophes, two 
apostrophes must be used to represent a 
single apostrophe. Any variable symbols 
used in the message operand are replaced by 
values assigned to them. Two ampersands 
must be used to represent a single 
ampersand that is not part of a variable 
symbol. 

The following example illustrates the 
use of the MNOTE instruction. 


r-r-r-*- 

JNaire |Operation! Operand 

I-- + -f- 



|MACRO 

1 

|SNAME 

j MOVE 

j ST,SF 


| AIF 

j (T'ST NE T'SF) .Ml 


| AIF 

j (T'ST NE *F') .M2 

| SNAME 

ST 

j 2,SAVEAREA 


|L 

1 2,SF 


|ST 

1 2,ST 


|L 

j 2,SAVEAREA 


j MNOTE 
|MEXIT 

|* , 'MOVE GENERATED' 

1 

J .Ml 

j MNOTE 
|MEXIT 

j 8,'TYPE NOT SAME' 

1 

| .M2 

j MNOTE 
j MEND 

j 8,'TYPE NOT F' 

1 


l-JL-JL 


The GELA, GBLB, and GBLC instructions 
define global SET symbols, just as the 
LOLA, LCLB, and LCLC instructions define 
the SET symbols described in Section 9. 
Hereinafter, SET symbols defined by LOLA, 
LCLB, and LCLC instructions will be called 
local SET symbols. 

Global SET symbols may communicate 
values between statements in one or mere 
macro definitions and statements outside 
macro definitions. However, local SET 
symbols communicate values between 
statements in the same macro definition, or 
between statements outside macro 
■j definitions. 

I 

| If a local SET symbol is defined in two 

| or more macro definitions, or in a macro 
! definition and outside macro definitions, 

j the SET symbol is considered to be a 

j different SET symbol in each case. 

| However, a global SET symbol is the same 

| SET symbol each place it is defined. 

I 

| A SET symbol must be defined as a global 

] SET symbol in each macro definition in 
j which it is to be used as a global SET 
j symbol. A SET symbol must be defined as a 
I global SET symbol outside macro 
J definitions, if it is to be used as a 
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global SET syirbol outside macro 
definitions. 

If the same SET symbol is defined as a 
global SET symbol in one or more places, 
and as a local SET symbol elsewhere, it is 
considered the same symbol wherever it is 
defined as a global SET symbol, and a 
different symbol wherever it is defined as 
a local SET symbol. 


Ml GBLA, GBLB, and GBIC instructions in 
a macro definition must appear before all 
LCLA, ICLE, and LCIC instructions in that 
macro definition. All GBLA, GBLB, and GBIC 
instructions outside macro definitions must 
appear before all LCLA, LCLB, and LCLC 
instructions outside macro definitions. 


USING GLOBAL AND LOCAL SET SYMBOLS 


DEFINING LOCAL AND GLOBAL SET SYMBOLS 


Local SET symbols are defined when they 
appear in the operand entry of an LCLA, 
LCLB, or LCLC instruction. These 
instructions are discussed in Section 9 
under "Defining SET Symbols." 

Global SET symbols are defined when they 
appear in the operand entry of a GBLA, 

GBLB, or GBLC instruction. The typical 
forms of these instructions are: 


The following examples illustrate the use 
cf global and local SET symbols. Each 
example consists of two parts. The first 
part is an assembler language source 
program. The second part shows the 
statements that would be generated by the 
assembler after it processed the statements 
in the source program. 

Example 1 : This example illustrates how 
the same SET symbol can be used to 
communicate (1) values between statements 
in the same macro definitions, and (2) 
different values between statements outside 
macro definitions. 


r- 

| Name 

V - 

|Not used, 
(must not 
|be present 
I 
I 


j OperationjOperand 


GBLA, 

GBLB, or 
GBLC 


|One or more 
j variable 
jsymbols that are 
j to be used as 
(global SET 
j symbols, sepa- 
jrated by commas 

j_ 


The GBLA, GBLB, and GBLC instructions 
define global SETA, SETB, and SETC symbols, 
respectively, and assign the same initial 
values as the corresponding types of local 
SET symbols. However, a global SET symbol 
is assigned an initial value by only the 
first GBLA, GBLB, or GBLC instruction 
processed in which the symbol appears. 
Subsequent GBLA, GBLB, or GBLC instructions 
processed by the assembler do not affect 
the value assigned to the SET symbol. 

The programmer should not define any 
global SET symbols whose first four 
characters are SSYS. 

If a GELA, GELE, or GBLC instruction is 
part of a macro definition, it must 
immediately follow the prototype statement, 
or another GELA, GELB, or GBLC instruction. 
GELA, GBLE, and GELC instructions outside 
macro definitions must appear after all 
macro definitions in the source program, 
before all conditional assembly 
instructions and PUNCH and REPRO statements 
outside macro definitions, and before the 
first control section of the program. 


J Name 

L 

"7 “ T -- 

(Operation(Operand 

_L J. 

r 

1 

T 

1 

| MACRO 

1 

|SNAME 

|LOADA 

I 

1| 

(LCLA 

j SA 

2(SNAME 

j LR 

|15,SA 

3 j SA 

(SETA 

j SA+1 

1 

1 

jtfEKD 

i 

1 

1 

1 

*1 

i 

(LCLA 

1 

j SA 

FIRST 

LCADA 

1 

5| 

(LR 

|15,SA 

1 

i 

|LOADA 


6| 

(LR 

115 , SA 

1 

(END 

(FIRST 

• 

i 

i 

r 

T 

T 

(FIRST 

(LR 

(15,0 

I 

(LR 

115,0 

1 

(LR 

(15,0 

1 

|LR 

(15,0 

I 

(END 

(FIRST 


I-L_L-J 


SA is defined as a local SETA symbol in 
a macro definition (statement 1) and 
cutside macro definitions (statement 4). 

SA is used twice within macro definition 
(statements 2 and 3) and twice cutside 
macro definitions (statements 5 and 6). 

Since SA is a local SETA symbol in the 
macro definition and outside macro 
definitions, it is one SETA symbol in the 
macro definition, and another SETA symbol 
cutside macro definitions. Therefore, 
statement 3 (which is in the macro 
definition) does not affect the value used 
fcr SA in statements 5 and 6 (which are 
cutside macro definitions). 
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E xample 2 : This example illustrates how a 
SET symbol can be used to communicate 
values between statements that are part cf 
a iracrc definition and statements outside 
macrc definitions. 


r- t-1-1 

| Name |Operation!Operand J 


r - 

*T - 

r - - — 

--1 

! 

(MACRO 

1 

I 

| SNAME 

| LOADA 

i 


1 | 

| GBLA 

| SA 


2 j SNAME 

j LR 

|15,SA 


3 ( SA 

j SETA 

| SA+1 


1 

f 

| MEND 

1 


4! 

i 

(GBLA 

1 

1 SA 

! 

(FIRST 

j LOADA 

i 


5 | 

j LR 

115,SA 


1 

LOADA 

1 


6 j 

(LR 

( 15,SA 


1 

| END 

(FIRST 


1 

r i, -r- 

i . _ 

j 

r 

~T 

T 

i 

|FIRST 

j LR 

(15,0 


1 

(LR 

| 15,1 


! 

j LR 

1 15,1 


1 

j LR 

(15,2 


I 

(END 

(FIRST 


L _ 

_X-- 

—1_ 

_j 


SA is defined as a global SETA symbol in 
a macrc definition (statement 1) and 
outside macrc definitions (statement 4). 

6A is used twice within the macrc 
definition (statements 2 and 3) and twice 
outside macro definitions (statements 5 and 
6 ) . 


Since SA is a global SETA symbol in the 
macrc definition and outside macro 
definitions, it is the same SETA symbol in 
both cases. Therefore, statement 3 (which 
is in the macro definition) affects the 
value used fcr SA in statements 5 and 6 
(which are cutside macro definitions). 


Example 3 : This example illustrates how 
the^ same SET symbol can be used to 
communicate: (1) values between statements 

in one macrc definition, and (2) different 
values between statements in a different 
macrc definition. 

SA is defined as a local SETA symbol in 
two different macro definitions (statements 
1 and 4). SA is used twice within each 
macrc definition (statements 2, 3, 5, and 
6 ). 


Since SA is a local SETA symbol in each 
macrc definition, it is one SETA symbol in 
one macrc definition, and another SETA 
symbol in the ether macro definition. 
Therefore, statement 3 (which is in one 
macrc definition) does not affect the value 
used fcr SA in statement 5 (which is in the 
ether macrc definition). Similarly, 


statement 6 does not affect the value used 
for SA in statement 2. 


r-r- t- 1 

(Name (Operation[Operand | 


j.- 

*4 — 

-f- 

-1 

1 

(MACRO 

1 

1 

(SNAME 

(LOAEA 

1 

1 

1 | 

(LCIA 

| SA 

1 

2j SNAME 

(XR 

1 1 S , £A 

1 

3 j S A 

j SETA 

j SA+1 

1 

1 

(MENE 

1 

1 

I 

I 

1 

JMACRC 

1 

1 

1 

1 

1 

j LOAEE 

i 

1 

4 

(LCIA 

j SA 

1 

5 ( 

j T T? 

; i s . eb 

1 

6 j SA 

j SETA 

J SA+1 

1 

1 

1 

|MENE 

l 

1 

I 

1 

1 

1 

[FIRST 

i 

| LOADA 

1 

1 

1 

1 

1 

j LOAEE 

1 

1 

1 

jLOADA 

1 

1 

1 

[LOADE 

1 

1 

1 

(END 

(FIRST 

1 

i _ 

4 

4 

1 

r 

"T 

T 

1 

(FIRST 

LR 

115,0 

1 

1 

(LR 

(15,0 

1 

1 

(LR 

(15,0 

I 

! 

| LR 

115,0 

1 

! 

| ENE 

(FIRST 

1 

i __ 

-J_ 

X _ _ 



Example 4 : This example illustrates how a 
SET symbol can be used to communicate 
values between statements that are part of 
two different macro definitions. 


r - r -T- 

|Name |Operation(Operand 


SNAME 

SNAME 

SA 


SA 


FIRST 


MACRO 

LOAEA 

GELA 

LR 

SETA 

MENE 

MACRO 

LOAEE 

GELA 

LR 

SETA 

MENE 

LOAEA 

LOAEE 

LOAEA 

LOADB 

ENE 


SA 

15, SA 
SA+1 


SA 

15, SA 
SA+1 


FIRST 


FIRST 


LR 

LR 

LR 

LR 

ENE 


15,0 

15.1 

15.2 

15.3 
FIRST 
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gA is defined as a global SETA symbol in 
two different macro definitions (statements 
1 and 4). gA is used twice within each 
macro definition (statements 2, 3, 5, and 
6 ). 


Since SA is a global SETA symbol in each 
macro definition, it is the same SETA 
symbol in each macro definition. 

Therefore, statement 3 (which is in cne 
macro definition) affects the value used 
for SA in statement 5 (which is in the 
ether macro definition). Similarly, 
statement 6 affects the value used for SA 
in statement 2. 


Since SA is a global SETA symbol in each 
macro definition, it is the same SETA 
symbol in each macro definition. However, 
since SA is a local SETA symbol outside 
macro definitions, it is a different SETA 
symbol cutside macro definitions. 

Therefore, statement 3 (which is in one 
macro definition) affects the value used 
fer SA in statement 5 (which is in the 
ether macro definition), but it does not 
affect the value used for SA in statements 
8 and 9 (which are outside macro 
definitions) . Similarly, statement 6 
affects the value used for SA in statement 
2, but it does not affect the value used 
fer SA in statements 8 and 9. 


Example 5 : This example illustrates how 
the same SET symbol can be used tc 
communicate: (1) values between statements 

in two different macro definitions, and (2) 
different values between statements outside 
macro definitions. 


r- T - T - 

| Name |Operation]Operand | 

I--+-f-^ 


r - 

T-— 

1-- - - - — — - - 


|MACRO 

1 

|SNAME 

j LOADA 



j GBLA 

| gA 

]SNAME 

j LR 

| 15,gA 

j SA 

j SETA 

j SA+1 


j MEND 

1 


i 

]MACRO 

1 


|LOADB 

I 


| GBLA 

j 6A 


j LR 

115,gA 

1 gA 

j SETA 

j gA+1 


| MEND 

i 

1 


i 

j LCLA 

1 

j gA 

1 FIRST 

|LOADA 

1 


|LOADB 



j LR 

| 15,gA 


j LOADA 

1 


|LOADB 

1 


j LR 

|15,gA 


j END 

jFIRST 

L — 

j_ - __ 

i _ 

1 

t 

1 

] FIRST 

] LR 

1 15,0 


j LR 

1 15,1 


j LR 

1 15,0 


j LR 

1 15,2 


| LR 

1 15,3 


j LR 

! 15,0 


j END 

jFIRST 

1__ 

-X 

X 


SA is defined as a global SETA symbol in 
two different macro definitions (statements 
1 and 4), but it is defined as a lccal SETA 
symbol outside macro definitions (statement 
7). SA is used twice within each macro 
definition and twice outside macro 
definitions (statements 2, 3, 5, 6, 8, and 

9 ) - 


SUESCRIPTED SET SYMBOLS 


Eoth global and local SET symbols may be 
defined as subscripted SET symbols. The 
local SET symbols defined in Section 9 were 
all nonsubscripted SET symbols. 

Subscripted SET symbols provide the 
programmer with a convenient way to use one 
SET symbol plus a subscript to refer to 
many arithmetic, binary, or character 
values. 

A subscripted SET symbol consists of a 
SET symbol immediately followed by a 
subscript that is enclosed in parentheses. 
The subscript may be any arithmetic 
expression that is allowed in the operand 
of a SETA statement in the range of 1 to 
the specified dimension. 

Only five levels of parentheses are 
permitted in a SETA or SETE operand. 

The following are valid subscripted SET 
symbols. 

gREADER (17) 

6A23456 (£S4) 

64F2 (25+SA2) 

The following are invalid subscripted 
SET symbols. 

SX4F2 (no subscript) 

(25) (no SET symbol) 

&X4F2 (25) (subscript does not 

immediately follow 
SET symbol) 

Defining Subscripted SET Symbols . If the 
programmer wants to use a subscripted SET 
symbol, he must write in a GBLA, GBLB, 

GBLC, LCLA, LCLE, or LCLC instruction, a 
SET symbol immediately followed by an 
unsigned decimal integer enclosed in 
parentheses. The decimal integer, called a 
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dimension, indicates the number cf SET 
variables associated with the SET symbol. 
Every variable associated with a SET symbol 
is assigned an initial value that is the 
same as the initial value assigned to the 
corresponding type of nonsubscripted SET 
symbol. 

If a subscripted SET symbol is defined 
as global, the same dimension must be used 
with the SET symbol each time it is defined 
as global. 

The maximum dimension that can be used 
with a SETA, SETE, or SETC symbol is 255. 


A subscripted SET symbol may be used 
only if the declaration was subscripted. A 
ncnsubscripted SET symbol may be used only 
if the declaration had no subscript. 

The following statements define the 
global SET symbols SSEOX, SWEOX, and SPSW, 
and the local SET symbol STSW. SSEOX has 
50 arithmetic variables associated with it, 
SWEOX has 20 character variables, SPSW and 
STSW each have 230 binary variables. 


r- t-t- 1 

{Name JOperationJOperand J 


— - _ T - 

— r -- -- 

j GBLA 

| SSBOX (50) 

j GBLC 

j SWBOX (20) 

|GBLB 

j SPSW (230) 

j LCLB 

| STSW (230) 

X-- 



U sing Subscripted SET Symbols . After the 
programmer has associated a number of SET 
variables with a SET symbol, he may assign 
values to each of the variables and use 
them in other statements. 

If the statements in the previous 
example were part of a macro definition, 

(and SA was defined as a SETA symbol in the 
same definition) , the following statements 
could be part of the same macro definition. 


Name 

T - T --- 

| Operation)Operand 

— 1 
1 

_j 

SA 

T 

j SETA 

T 

|5 

— 1 

SPSW (SA) 

| SETB 

1 (6 LT 2) 


STSW (9) 

I SETE 

| (SPSW (SA) ) 



|A 

| CL I 
.X 

j 2,=F' SSBOX (45) * 
j AREA,C*SWBOX (17) ' 

_J 


Statement 1 assigns the arithmetic value 
5 to the nonsubscripted SETA symbol SA. 
Statements 2 and 3 then assign the binary 
value 0 to subscripted SETB symbols SPSW (5) 
and STSW (9) , respectively. Statements 4 
and 5 generate statements that add the 
value assigned to SSEOX (45) to general 
register 2, and compare the value assigned 


tc SWEOX (17) to the value stored at AREA, 
respectively. 


System Variable Symbols 


System variable symbols are local variable 
symbols that are assigned values 
automatically by the assembler. There are 
fcur system variable symbols: SSYSNEX, 

S SYSECT, 6SYSIIST, and SSYSPA.RM. System 
variable symbols may be used in the name, 
operation and operand entries of statements 
in macro definitions, but not in statements 
outside macro definitions with the 
exception of SSYSFARM. They may not be 
defined as symbolic parameters or SET 
symbols, nor may they be assigned values by 
SETA, SETB, and SETC instructions. 


SSYSNEX—MACRO INSTRUCTION INDEX 


The system variable symbol SSYSNEX may be 
combined with other characters to create 
unique names for statements generated from 
the same model statement. 

SSYSNDX is assigned the four-digit 
number 0001 for the first macro instruction 
processed by the assembler, and it is 
incremented by one for each subsequent 
inner and outer macro instruction 
processed. 

If SSYSNEX is used in a model statement, 
SETC or MNCTE instruction, or a character 
relation in a SETE or A1F instruction, the 
value substituted for SSYSNEX is the 
four-digit number of the macro instruction 
being processed, including leading zeros. 

If SSYSNEX appears in arithmetic 
expressions (e.g., in the operand of a SETA 
instruction), the value used for SSYSNEX is 
an arithmetic value. 

Throughout one use of a macro 
definition, the value of SSYSNDX may be 
considered a constant, independent of any 
inner macro instruction in that d efinition . 

The example in the next column 
illustrates these rules. it is assumed 
that the first macro instruction processed, 
OUTER 1, is the 106th macro instruction 
processed by the assembler. 

Statement 7 is the 106th iracrc 
instruction processed. Therefore, SSYSNEX 
is assigned the number 0106 for that macro 
instruction. The number 0106 is 
substituted for SSYSNEX when it is used in 
statements 4 and 6. Statement 4 is used to 
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assign the character value 0106 to the SETC 
symbol SNDXNUM. Statement 6 is used to 
create the unique name E0106. 


f - T -T-T 

|Name | Operation!Operand j 


F- 

f- 

-f- 

-1 

1 

j MACRO 

1 


1 

j INNER 1 

I 


1 

| GBLC 

j SNDXNUM 


1 j ASSYSNDX 

| SR 

1 2,5 


1 

! CR 

1 2,5 


2 j 

| BE 

|BSNDXNUM 


3 j 

1 B 

jASSYSNDX 


1 

1 

j MEND 

l 

! 

1 


1 

1 

i 

J MACRO 

1 

1 


j SNAME 

| OUTER 1 

1 


I 

| GBLC 

1SNDXNUM 


4|SNDXNUM 

j SETC 

j•SSYSNDX* 


|SNAME 

j SR 

12,4 


1 

| AR 

1 2, 6 


5 j 

INNER1 

1 


6 j B SSYSNDX 

1 s 

12,=F* 1000' 


1 

j MEND 

1 


i 



j 

r 

i j— 

T - 

r - 

1 

7 jALPHA 

j OUTER 1 

1 


8 j BETA 

j OUTER1 

1 


J 

1 

L 

.. i 

r ^ 

1 

r 

1 

jALPHA 

j SR 

12,4 


1 

| AR 

12,6 


jAO107 

| SR 

1 2, 5 



j CR 

1 2,5 


1 

BE 

|B0106 


1 

B 

J A0 107 


JB0106 

1 ^ 

I2,=F'1000' 


{BETA 

j SR 

1 2, 4 


1 

j AR 

I 2,6 


JA0109 

j SR 

! 2,5 


I 

j CR 

I 2,5 


1 

BE 

j B0108 



B 

j A0109 


|B0108 

1 s 

|2,=F'1000* 


i _ 

J.- 

_i.- 

_i 

Statement 

5 is the 

107th macro 


instruction processed. 

Therefore, SSYSNDX 

is assigned the number 

0107 for that 

macro 


instruction. The number 0107 is 
substituted for SSYSNEX when it is used in 
statements 1 and 3. The number 0106 is 
substituted for the global SETC symbol 
SNEXNUM in statement 2. 

Statement 8 is the 108th macro 
instruction processed. Therefore,each 
occurrence of SSYSNEX is replaced by the 
number 0108. For example, statement 6 is 
used to create the unique name E0108. 

When statement 5 is used to process the 
108th macro instruction, statement 5 
becomes the 109th macro instruction 
processed. Therefore, each occurrence of 
SSYSNDX is replaced by the number 0109. 

For example, statement 1 is used to create 
the unique name A0109. 


SSYSECT—CURRENT CCNTRCL SECTION 


The system variable symbol SSYSECT may be 
used to represent the name of the control 
section in which a macro instruction 
appears. For each inner and outer macro 
instruction processed by the assembler, 
SSYSECT is assigned a value that is the 
name of the control section in which the 
macro instruction appears. 


When SSYSECT is used in a macro 
definition, the value substituted for 
SSYSECT is the name of the last CSECT, 
DSECT, or START statement that occurs 
before the macro instruction. If no named 
CSECT, DSECT, or START statements occur 
before a macro instruction, SSYSECT is 
assigned a null character value for that 
macro instruction. 


CSECT or DSECT statements processed in a 
macro definition affect the value of 
SSYSECT for any subsequent inner macro 
instructions in that definition, and for 
any other outer and inner macro 
instructions. 


Throughout the use of a macro 
definition, the value of SSYSECT may be 
considered a constant, independent of any 
CSECT or DSECT statements or inner macro 
instructions in that definition. SSYSECT 
will take on the name of the last CSECT, 
DSECT, or START statement regardless of 
whether or not that statement is correct. 

The next example illustrates these 
rules. 

Statement 8 is the last CSECT, ESECT, or 
START statement processed before statement 
9 is processed. Therefore, SSYSECT is 
assigned the value MAINFRCG for macro 
instruction OUTER1 in statement 9. 

MAINPROG is substituted for SSYSECT when it 
appears in statement 6. 

Statement 3 is the last CSECT, ESECT, or 
START statement processed before statement 
4 is processed. Therefore, SSYSECT is 
assigned the value CSCUT1 for macro 
instruction INNER in statement 4. CS0UT1 
is substituted for SSYSECT when it appears 
in statement 2. 

Statement 1 is used to generate a CSECT 
statement for statement 4. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 5. Therefore, 
SSYSECT is assigned the value INA for macro 
instruction INNER in statement 5. INA is 
substituted for SSYSECT when it appears in 
statement 2. 
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I Name 


h 


Operation)Operand 


9 

10 


€INCSECT 


CSOUT1 


[ - 

MAINPROG 


MAINPROG 


CSOUT1 


INA 


INB 


MACRO 

INNER 

CSECT 

DC 

MEND 

MACRO 
OUTER 1 
CSECT 
DS 

INNER 

INNER 

DC 

MEND 

MACRO 

OUTER2 

EC 

MEND 


CSECT 

DS 

OUTER 1 
OUTER2 


CSECT 

DS 

CSECT 

DS 

CSECT 

DC 

CSECT 

DC 

DC 

DC 


SINCSECT 
A (6SYSECT) 


100C 

INA 

INB 

A (6SYSECT) 


A (SSYSECT) 


200C 


200C 

100C 

A (CSOUT 1) 

A (INA) 

A (MAINPROG) 
A (INB) 


Statement 1 is used to generate a CSECT 
statement for statement 5. This is the 
last CSECT, DSECT, or START statement that 
appears before statement 10. Therefore, 
SSYSECT is assigned the value INB for macro 
instruction OUTER2 in statement 10. INB is 
substituted for 6SYSECT when it appears in 
statement 7. 


6SYSL1ST—ACCESSING POSITIONAL OPERANDS IN 
A MACRO INSTRUCTION 


The system variable symbol 6SYSLIST 
provides the programmer with an alternative 
to symbolic parameters for referring to 
positional macro instruction operands. 

&SYSLIST may be coded, along with all 
other variable symbols (including symbolic 
parameters), in the model statements of any 
macro definition. (In the Tape Operating 
System (TOS), 6SYSLIST cannot be used in 
macro definitions having any keyword 
symbolic parameters). When used to access 
a macro instruction operand, SSYSL1ST is 
written with one or two subscripts: 


1. SSYSLIST (m) will access the pcsitional 
macro instruction operand 
corresponding to the positional 
operand subscript m. The programmer, 
therefore, does not have to define a 
positional parameter in the macro 
definition prototype statement. This 
allows him to access a different 
number of positional macro instruction 
operands in different calls to the 
same macro. The positional operand 
subscript m can be a self-defining 
term or an absolute expression, but 
its value must be a positive, whole 
number within the range of the number 
of operands permitted in a macro 
instruction. 

Note : A null string will be generated in 

place of SSYSL1ST (m) if: 


a. m=0 

b. m is greater than the number of 
positional operands in the macro 
instruction. 

c. m accesses a specifically omitted 
operand. 

The model statement containing 
6SYSIIST(m) will be flagged in error 
if: 


a. m is negative. 

b. m is greater than 100 (for the E 
Assembler) . 

m is greater than 200 (for the F 
Assembler) . 

2. SSYSLIST (m,n) accesses elements of 
positional operand sublists in macro 
instructions. The positional operand 
subscript m fulfills the same function 
as above, and is subjected to the same 
restrictions. The positional operand 
sublist subscript n refers to the 
sublist element of the positional 
operand in a macro instruction 
corresponding to m. Again positional 
parameters need not have been 
previously defined in the macro 
definition prototype statement. 

Note : A null string will be generated in 
place of SSYSIIST (m,n), m > 0 and otherwise 
within its allowable range, if: 


a. n=0 

b. n is greater than the number of 
elements in the positional operand 
sublist in the macro instruction. 

c. n accesses a specifically omitted 
operand sublist element. 
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The type, length, scaling, integer, and 
count attributes of 6SYSLISTS (m) and 
SSYSLIST (m,n) and the number attributes of 
6SYSLIST (m) and SSYSLIST may be used in 
conditional assembly instructions. 
Attributes are discussed in Section 9 under 
"Attributes." 


N'SSYSLIST refers to the total number of 
positional operands in the macro 
instruction statement. When none have been 
called, N'SSYSLIST has the value 0. If, 
however, some positional operands in the 
macro instruction are specifically emitted 
(by means of commas), N'SSYSLIST will 
include the omitted operands in its count 
(see MAC2 and MAC3 in the examples below). 

A sublist is considered to be one operand 
(see MAC3 below) : 


r- 1 - 1 

|Macro Instructions |N'SSYSLISTj 

j.--j- 

| MAC 1: | J 

j K1=DS j 0 j 

1 I I 

|MAC2: | j 

I ,,K1=DC | 2 | 

I ! I 

j MAC 3: j j 

j FULL, ,F , ( , 1*,'2 , ,'3') ,KL=DC| 4 J 

L_J-J 


N'SSYSLIST (m) refers to the total number 
of elements in the macro instruction 
operand sublist corresponding to the 
positional operand subscript m. If the mth 
operand is omitted, N'SSYSLIST (n) is 0; if 
the mth operand is not a sublist, 

N'SSYSLIST (m) is 1. 

In the MAC3 macro instruction above: 

N'SSYSLIST (4) is 3 
N* SSYSLIST (5) is 0 
N'SSYSLIST (2) is 0 
N'SSYSLIST (1) is 1 


6SYSPARM - 
Assembly 


rstem Parameter for Conditional 


(EOS Assembler D, 14K variant, only) 

The system parameter 6SYSPARM allows the 
programmer to control conditional assembly 
flew and source code generation through the 
use of a parameter specified in a job 
control statement. Thus, the programmer 
can modify the output of an assembly 
without changing the source code itself. 
This can be convenient if an installation 
keeps sections of source code on tape or in 
a source statement library (SYSSLE) . 


The system parameter behaves like a 
global SETC symbol except that its value 
can be set only through the OPTION job 
control statement. It cannot be modified 
during assembly. SSYSPARM can be coded 
inside as well as outside macro 
definitions. SSYSPARM can be used only if 
SPARM=YES was specified in the STDJC macro 
when the system was generated. 

A value to the system parameter is 
assigned with a keyword parameter in the 
OPTION job control card: 

// OPTION ...,SYSPARM='string',... 

The system parameter will get the value of 
the string within the quotes, which must be 
a character string, 0-8 bytes long. It 
may consist of any combination of EBCDIC 
characters. A single quote in the string 
must be represented by two on the OPTION 
card. If no SSYSPARM value is specified, 
the value of the system parameter will be a 
null string. 


Keyword Macro Definitions and Instructions 

Keyword macro definitions provide the 
programmer with an alternate way of 
preparing macro definitions. 

A keyword macro definition enables a 
programmer to reduce the number of operands 
in each macro instruction that corresponds 
to the definition, and to write the 
operands in any order. 

The macro instructions that correspond 
to the macro definitions described in 
Section 7 (hereinafter called positional 
macro instructions and positional macro 
definitions, respectively) require the 
operands to be written in the same order as 
the corresponding symbolic parameters in 
the operand entry of the prototype 
statement. 

In a keyword macro definition, the 
programmer can assign values to any 
symbolic parameters that appear in the 
operand of the prototype statement. The 
value assigned to a symbolic parameter is 
substituted for the symbolic parameter, if 
the programmer does not write anything in 
the operand of the macro instruction to 
correspond to the symbolic parameter. 

When a keyword macro instruction is 
written, the programmer need only write one 
operand for each symbolic parameter whose 
value he wants to change. 

Keyword macro definitions are prepared 
the same way as positional macro 
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1 


definitions, except that the prototype 
statement is written differently, and 
SSYSLIST may not be used in the definition. 
The rules for preparing positional macro 
definitions are in Section 7. 


I-T-T- 

|Name (Operation|Operand 

I-4-4- 

| 6N (MOVE j £R=2,6A=S,£T=,£F= 

L- X -4.- 


I 

j 


KEYWORD 


DnmTAmvnt* 
riwxw x jl r Xh 


The typical form of this statement is: 


| Operationjuperana 


(.- 

(A symbolic 
j parameter 
|or not used| 


A symbol {One to 100 (200 
jfor F assembler) 
(operands of the 
(form described 
(below, separated 
jby commas. 

_r_ 


Each operand must consist of a symbolic 
parameter, immediately followed by an equal 
sign and optionally followed by a value. 
Nested keywords are not permitted. 

A value that is part of an operand must 
immediately follow the equal sign. 

Anything that may be used as an operand 
in a macro instruction except variable 
symbols, may be used as a value in a 
keyword prototype statement. The rules for 
forming valid macro instruction operands 
are detailed in Section 8. 


KEYWORD MACRO INSTRUCTION 


After a programmer has prepared a keyword 
macro definition he may use it by writing a 
keyword macro instruction. 

The typical form of a keyword macro 
instruction is: 


r- t-t- 1 

(Name |Operation|Operand ( 

j.-4-4-1 

(A symbol,(Mnemonic |Zero to 100 operands ( 
(sequence (operation! (200 for F Assembler)| 
|symbol jcode (of the form described) 

(or not j (below, separated by j 

(used j (commas j 

i-j.-j._j 


Each operand consists of a keyword 
immediately followed by an equal sign and 
an optional value. Nested keywords are not 
permitted. Anything that may be used as an 
operand in a positional macro instruction 
may be used as a value in a keyword macro 
instruction. The rules for forming valid 
positional macro instruction operands are 
detailed in Section 8. 

A keyword consists of one through seven 
letters and digits, the first of which must 
be a letter. 


The following are valid keyword 
prototype operands. 

6READER= 

6LOOP2=SYMBOL 
£S4==F'4096 * 

The following are invalid keyword 
prototype operands. 


The keyword part of each keyword macro 
instruction operand must correspond to one 
of the symbolic parameters that appears in 
the operand of the keyword prototype 
statement. A keyword corresponds to a 
symbolic parameter if the characters of the 
keyword are identical to the characters of 
the symbolic parameter that follow the 
ampersand. 


CARDAREA 
£TYPE 
6TWO =123 


£AREA= X * 18 9A * 


(no symbolic parameter) 
(no equal sign) 

(equal sign does not 
immediately fellow 
symbolic parameter) 

(value does not 
immediately follow equal 
sign) 


The following keyword prototype 
statement contains a symbolic parameter in 
the name entry and four operand entries in 
the operand. Tho first two operand entries 
contain values. The mnemonic operation 
code is MOVE. 


The following are valid keyword macro 
instruction operands. 

LOOP2=SYMBOL 
S4==F'4096' 

TO= 


The following are invalid keyword macro 
instruction operands. 


£X4F2=0 (2,3) 
CARDAREA=A+2 
= (TC (8) , (FROM) ) 


(keyword does not begin 
with a letter) 

(keyword is more than 
seven characters) 

(no keyword) 
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The operands in a keyword macro 
instruction may be written in any order. 

If an operand appeared in a keyword 
prototype statement, a corresponding 
operand does net have to appear in the 
keyword macro instruction. If an operand 
is omitted, the comma that would have 
separated it from the next operand need not 
be written. 

The following rules are used to replace 
the symbolic parameters in the statements 
of a keyword macro definition. 

1. If a symbolic parameter appears in the 
name entry of the prototype statement, 
and the name entry of the macro 
instruction contains a symbol, the 
symbolic parameter is replaced by the 
symbol. If the name entry of the 
macro instruction is unused or 
contains a sequence symbol, the 
symbolic parameter is replaced by a 
null character value. 

2. If a symbolic parameter appears in the 
operand of the prototype statement, 
and the macro instruction contains a 
keyword that corresponds to the 
symbolic parameter, the value assigned 
to the keyword replaces the symbolic 
parameter. 


symbol, SN is replaced by HERE in statement 

2 . 


r- r - T - 

|Name |Operation{Operand 


■4 - 

(MACRO 
j MOVE 
| ST 
|L 
|ST 
|L 

(MEND 


1 (SN 

2 j SN 

31 
“I 
51 


j £R=2 , SA=S , £T= , 6F= 
| SR , SA 
j SR , SF 
j SR , ST 
j SR , SA 


HERE 

r — 

(MOVE 

-j 

—4- 

|T=FA,F=FB,A=THERE 

j . . ... , T 

HERE 

|ST 

(2,THERE 


|L 

I 2 ,FB 


|ST 

12,FA 


|L 

J2,THERE 


—1- - 

-L_____ 


Since ST appears in the operand of 
statement 1, and statement 6 contains the 
keyword (T) that corresponds to ST, the 
value assigned to T (FA) replaces ST in 
statement 4. Similarly, FE and THERE 
replace SF and SA in statement 3 and in 
statements 2 and 5, respectively. Note 
that the value assigned to SA in statement 
6 is used instead of the value assigned to 
SA in statement 1. 


3. If a symbolic parameter was assigned a 
value by a prototype statement, and 
the macro instruction does not contain 
a keyword that corresponds to the 
symbolic parameter, the standard value 
assigned to the symbolic parameter 
replaces the symbolic parameter. 
Otherwise, the symbolic parameter is 
replaced by a null character value. 


Note : If a symbolic parameter value is a 
self-defining term the type attribute 
assigned to the value is the letter N. If 
a symbolic parameter value is omitted the 
type attribute assigned to the value is 
the letter 0. All other values are assigned 
the type attribute U. 


Since SR appears in the operand of 
statement 1, and statement 6 does not 
contain a corresponding keyword, the value 
assigned to SR (2) , replaces SR in 
statements 2, 3, 4, and 5. 


Operand Sublists . The value assigned to a 
keyword and the value assigned to a 
symbolic parameter may be an operand 
sublist. Anything that may be used as an 
operand sublist in a positional macro 
instruction may be used as a value in a 
keyword macro instruction and as a value in 
a keyword prototype statement. The rules 
for forming valid operand sublists are 
detailed in Section 8 under "Operand 
Sublists." 


The following keyword macro definition, 
keyword macro instruction, and generated 
statements illustrate these rules. 

Statement 1 assigns the values 2 and S 
to the symbolic parameters SR and SA, 
respectively. Statement 6 assigns the 
values FA, FE, and THERE to the keywords T, 
F, and A, respectively. The symbol HERE is 
used in the name entry of statement 6. 

Since a symbolic parameter (SN) appears 
in the name entry of the prototype 
statement (statement 1) , and the 
corresponding characters (HERE) of the 
macro instruction (statement 6) are a 


Keyword Inner Macro Instructions . Keyword 
and positional inner macro instructions may 
be used as model statements in either 
keyword or positional macro definitions. 


Mixed-Mode Macro Definitions and 
Instructions 

Mixed-mode macro definitions allcw the 
programmer to use the features of keyword 
and positional macro definitions in the 
same macro definition. 
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Mixed-mode macro definitions are 
prepared the same way as positional iracrc 
definitions, except that the prototype 
statement is written differently. (In TOS 
SYSLIST may not be used in the definition.) 
The rules for preparing positional macro 
definitions are in Section 7. 


The operand consists of two parts. The 
first part corresponds to the positional 
prototype operands. This part of the 
operand is written in the same way that the 
operand entry of a positional macro 
instruction is written. The rules for 
writing positional macro instructions are 
in Section 8. 


MIXEE-MOEE PROTOTYPE 


The typical form of this statement is: 


T-T- 

| Operation|Operand 

\ -i- 

A symbol |Two to 100 (200 
|for F assembler) 

|operands of the 
|form described 
jbelow, separated 
jby commas 

-1_ 


I Name 


h- 

|A symbolic 
j parameter 
j or not used 


The second part of the operand 
corresponds to the keyword prototype 
operands. This part of the operand is 
written in the same way that the operand 
entry of a keyword macro instruction is 
written. The rules for writing keyword 
macro instructions are described under 
"Keyword Macro Instruction," 


The following mixed-mode macro 
definition, mixed-mode macro instruction, 
and generated statements illustrate these 
facilities. 


The operands must be valid operands of 
positional and keyword prototype 
statements. All the positional operands 
must precede the first keyword operand. 

The rules for forming positional operands 
are discussed in Section 7 under "Macro 
Instruction Prototype." The rules for 
forming keyword operands are discussed 
under "Keyword Prototype." 

The following sample mixed-mode 
prototype statement contains three 
positional operands and two keyword 
operands. 

r-r-1-1 

|Name |Operation!Operand j 

I--+-f-^ 

16N |MOVE j STY,£P,6R,6TC=,SF= 1 

L-X-X_J 


MIXEE-MOEE MACRO INSTRUCTION 


The typical form of a mixed-mode macro 
instruction is: 

r - T - T -T 

|Name |Operation!Operand j 


j A symbol,|Mnemonic jzero to 100 operands j 
|sequence joperation! (200 for F Assembler) j 
jsymbol (code jof the form described) 
jor not j jbelow, separated by j 
!used j jcommas j 
i-x-x_j 


j Name 

I 

1 J SN 
I&N 


I 

j.- 

2 j HERE 
! HERE 


L. 


[Operation|Operand 

4-4--- 

JMACRO | 

JMOVE |€TY,SF,SR,STO=,SF= 

JSTSTY j SR,SAVE 

|LSTY j SR,SF6F 

|STSTY |SR,6FST0 

JL6TY jSR,SAVE 

4-4--— 

jMOVE j H,,2,F=FB,TO=FA 

+-+- 

jSTH j2,SAVE 

|LH j 2,FB 

j STH |2,FA 

|LH j2,SAVE 


1 

I 

i 


H 

I 

H 


j 


The prototype statement (statement 1) 
contains three positional operands (6TY,SP, 
and SR) and two keyword operands (Sto and 
SF) . In the macro instruction (statement 
2) the positional operands are written in 
the same order as the positional operands 
in the prototype statement (the second 
operand is omitted). The keyword operands 
are written in an order that is different 
from the order of keyword operands in the 
prototype statement. 


Mixed-mode inner macro instructions may 
be used as model statements in mixed’-mode, 
keyword, and positional macro definitions. 
Keyword and positional inner macro 
instructions may be used as model 
statements in mixed-mode macro definitions. 
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Conditional Assembly Compatibility 


Macro definitions prepared for use with the 
other IBM System/360 Operating System 
assemblers having macro language facilities 
may be used with the DOS/TOS assembler 
provided that all SET symbols are declared 


in an appropriate LCLA, LCLB, LCLC, GBLA, 
GBLB, or GBLC statement. The AIFB and AGOB 
instructions are processed by the DOS/TOS 
assembler the same way that the AIF and AGO 
instructions are processed. AIFB and AGOB 
instructions cause the count set up by the 
ACTR instruction to be decremented exactly 
like the AGO and AIF instructions. 
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Appendix A. Extended Binary Coded Decimal 
Interchange Code (EBCDIC) 


The following charts and the associated key 
show the bit configurations of the 256 
possible codes (characters) of the Extended 
BCD Interchange Code. To write a given 
character in binary, locate the character 
on the chart. The top row of coordinates 
equates to bit positions 0 and 1, the 
second row to bit positions 2 and 3, and 
the left row of coordinates equates to bit 
positions 4, 5, 6 and 7. 

Examples : 

Character A equals: 

top row—11 (bit positions 0, 1) 

2nd row—00 (bit positions 2, 3) 

left row—0001 (bit positions 4,5, 6 
and 7) 

Therefore, character A is shown as: 

1100 0001 

Character $ equals: 

top row—01 (bit positions 0, 1) 

2nd row--01 (bit positions 2,. 3) 

left row—1011 (bit positions 4, 5, 6 
and 7) 


Therefore, character $ is shown as: 


0101 1011 


The coordinates on the bottom of the 
chart are the three zone punches required 
to reproduce the character in a punched 
card; the coordinates on the right side 
represent the numeric punches. 


Examples : 


Character A = bottom row—12 punch 
right row— 1 punch 

Therefore, character A is shown by a 12 
and a 1 punch in the same card column. 

Character $ = bottom row--11 punch 

right row—8 and 3 punches 

Therefore, character $ is shown by 11, 
8, and 3 punches in the same card column. 

There are fifteen exceptions to the 
punching equated to bit positions. These 
exceptions are shown in the chart by 
circled numbers 1 through 15, and the 
substituted punching is shown below the 
chart under "Exceptions." 
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Control Characters 


PF 

Punch Off 

BS 

Backspace 

PN 

Funch On 

HT 

Horizontal Tab 

IL 

Idle 

RS 

Reader Stop 

LC 

Lower Case 

BY 

Bypass 

uc 

Upper Case 

DL 

Delete 

LF 

Line Feed 

ET 

End of Transmission 

RE 

Restore 

EB 

End of Block 

SM 

Set Mode 

NL 

New Line 

PR 

Prefix 

SP 

Space 

DS 

Digit Select 

SOS 

Start of Significance 

FS 

Field Separator 


Special Graphic Characters 


l Cent Sign * Asterisk 

. Period, Decimal Point ) Right Parenthesis 

< Less-than Sign j Semicolon 

( Left Parenthesis -» Logical NOT 

+ Plus Sign - Minus Sign, Hyphen 

| Vertical Bar, Logical OR / Slash 

S Ampersand , Comma 

! Exclamation Point % Percent 

$ Dollar Sign _ Underscore 


> Greater-than Sign 
? Question Mark 
: Colon 
# Number Sign 
a At Sign 
1 Prime, Apostrophe 
» Equal Sign 
" Quotation Mark 


f-T- 

I ! 

|Examples | Type 

I I 

h-4- 

| PF | Control Character 


j % j Special Graphic 

H-4- 

| R | Upper Case 

f-f- 

| a | Lower Case 

j.-1- 

S | Control Character, 

j j function not yet 

j j assigned 


Figure 15. Extended Einary Coded Decimal Interchange Code (Part 2 of 2) 


t -r-1 

( Bit Pattern | Hole Fattern j 

j Bit Positions |- T -—J 

j 0 1 23 4567 j Zone Punches | Digit Punches j 

4-^-1-1 

| 00 00 0100 | 12-9-4 | 

i-4-+-1 

| 01 10 1100 | JO—8—4 | 

4-[-4-1 

j 11 01 1001 I 11-9 I 

4 - 4 -+-■( 

| 10 00 0001 j 12-0-1 i 

4-4-4-1 

| 00 11 0000 I 12-11-0-9-8-1 | 
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Appendix B. Hexadecimal-Decimal Number Conversion Table 


The table in this appendix provides for For example, the decimal number 123 has 

direct conversion of decimal and the hexadecimal equivalent of 07B; the 

hexadecimal numbers in these ranges: decimal number 1478 has the hexadecimal 

equivalent of 5C6. 


r-1-1 

| Hexadecimal |Decimal J 

[.-f-J For numbers outside the range of the 

j 000 to FFF jOOOO to 4095 j table, add the following values to the 

i- 1 - » table 


Decimal numbers (0000-4095) are given 
within the 5-part table. The first two 
characters (high-order) of hexadecimal 
numbers (000-FFF) are given in the lefthand 
column of the table; the third character 
(x) is arranged across the top of each part 
of the table. 

To find the decimal equivalent of the 
hexadecimal number 0C9, look for 0C in the 
left column, and across that row under the 
column for x = 9. The decimal number is 
0201 . 

To convert from decimal to hexadecimal, 
look up the decimal number within the table 
and read the hexadecimal number by a 
combination of the hex characters in the 
left column, and the value for x at the top 
of the column containing the decimal 
number. 


(Hexadecimal (Decimal j 
|-+- 1 


1000 

| 4096 

2000 

| 8192 

3000 

| 12288 

4000 

( 16384 

5000 

| 20480 

6000 

| 24576 

7000 

j 28672 

8000 

J 32768 

9000 

( 36864 

A000 

| 40960 

B000 

| 45056 

cooo 

| 49152 

D000 

( 53248 

E000 

j 57344 

F000 

| 61440 
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x * 0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

0 

£ 

F 

OOx 

0000 

0001 

0002 

0003 

0004 

0005 

0006 

0007 

0008 

0009 

0010 

0011 

0012 

0013 

0014 

0015 

Olx 

0016 

0017 

0018 

0019 

0020 

0021 

0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

0030 

0031 

02x 

0032 

0033 

0034 

0035 

0036 

0037 

0038 

0039 

0040 

0041 

0042 

0043 

0044 

0045 

0046 

0047 

03x 

0048 

0049 

0050 

0051 

0052 

0053 

0054 

0055 

0056 

0057 

0058 

0059 

0060 

0061 

0062 

0063 

0«x 

0064 

0065 

0066 

0067 

0068 

0069 

0070 

0071 

0072 

0073 

0074 

0075 

0076 

0077 

0078 

0079 

05x 

0080 

0081 

0082 

0083 

0084 

0085 

0086 

0087 

0088 

0089 

0090 

0091 

0092 

0093 

0094 

0095 

06x 

0096 

0097 

0098 

0099 

0100 

0101 

0102 

0103 

0104 

0105 

0106 

0107 

0108 

0109 

0110 

0111 

07x 

0112 

0113 

0114 

0115 

0116 

0117 

0118 

0119 

0120 

0121 

0122 

0123 

0124 

0125 

0126 

0127 

08x 

0128 

0129 

0130 

0131 

0132 

0133 

0134 

0135 

0136 

0137 

0138 

0139 

0140 

0141 

0142 

0143 

09x 

0144 

0145 

0146 

0147 

0148 

0149 

OISO 

0151 

0152 

0153 

015a 

0155 

0156 

0157 

0158 

0154 

OAx 

0160 

0161 

0162 

0163 

0164 

0165 

0166 

0167 

0168 

0169 

0170 

0171 

0172 

0173 

0174 

0175 

OBx 

0176 

0177 

0178 

0179 

0180 

0181 

0182 

0183 

0184 

0185 

0186 

0187 

0188 

0189 

0190 

0191 

OCx 

0192 

0193 

0194 

0195 

0196 

0197 

0198 

0199 

0200 

0201 

0202 

0203 

0204 

0205 

0206 

0207 

ODx 

0208 

0209 

0210 

0211 

0212 

0213 

0214 

0215 

0216 

0217 

0218 

0219 

0220 

0221 

0222 

0223 

OEx 

0224 

0225 

0226 

0227 

0228 

0229 

0230 

0231 

0232 

0233 

0234 

0235 

0236 

0237 

0238 

0239 

OFx 

0240 

0241 

0242 

0243 

0244 

0245 

0246 

0247 

0248 

0249 

0250 

0251 

0252 

0253 

0254 

0255 

■ WA 


0257 

0253 

0259 

0200 

02o 1 

0202 

0203 

OioH 


02oo 

02o7 

U4QO 


0270 

027 i 

11x 

0272 

0273 

0274 

0275 

0276 

0277 

0278 

0279 

0280 

0281 

0282 

0283 

0284 

0285 

0286 

0287 

12x 

0288 

0289 

0290 

0291 

0292 

0293 

0294 

0295 

0296 

0297 

0298 

0299 

0300 

0301 

0302 

0303 

13x 

0304 

0305 

0306 

0307 

0308 

0309 

0310 

0311 

0512 

0313 

0314 

0315 

0316 

0317 

0318 

0319 

14x 

0320 

0321 

0322 

0323 

0324 

0325 

0326 

0327 

0328 

0329 

0330 

0331 

0332 

0333 

0334 

0335 

15x 

0336 

0337 

0338 

0339 

0340 

0341 

0342 

0343 

0344 

0345 

0346 

0347 

0348 

0349 

0350 

0351 

16x 

0352 

0353 

0354 

0355 

0356 

0357 

0358 

0359 

0360 

0361 

0362 

0363 

0364 

0365 

0366 

0367 

17x 

0368 

0369 

0370 

0371 

0372 

0373 

0374 

0375 

0376 

0377 

0378 

0379 

0380 

0381 

0382 

0383 

18x 

0384 

0385 

0386 

0387 

0388 

0389 

0390 

0391 

0392 

0393 

0394 

0395 

0396 

0397 

0398 

0399 

19x 

0400 

0401 

0402 

04D3 

0404 

0405 

0406 

0407 

0408 

0409 

0410 

0411 

0412 

0413 

0414 

0415 

lAx 

0416 

0417 

0418 

041? 

0420 

0421 

0422 

0423 

0424 

0425 

0426 

0427 

0428 

0429 

0430 

0431 

IBx 

0432 

0433 

0434 

0435 

0436 

0437 

0438 

0439 

0440 

0441 

0442 

0443 

0444 

0445 

0446 

0447 

ICx 

0448 

0449 

0450 

0451 

0452 

0453 

0454 

0455 

0456 

0457 

0458 

0459 

0460 

0461 

0462 

0463 

IDx 

0464 

0465 

0466 

04 67 

0468 

0469 

0470 

0471 

0472 

0473 

0474 

0475 

0476 

0477 

0478 

0479 

lEx 

0480 

0481 

0482 

04 83 

0484 

0485 

0486 

0487 

0488 

0489 

0490 

0491 

0492 

0493 

0494 

0495 

IFx 

0496 

0497 

0498 

04 99 

0500 

0501 

0502 

0503 

0504 

0505 

0506 

0507 

0508 

0509 

0510 

0511 

20x 

0512 

0513 

0514 

0515 

0516 

0517 

0518 

0519 

0520 

0521 

0522 

0523 

0524 

0525 

0526 

0527 

21x 

0528 

0529 

0530 

0531 

0532 

0533 

0534 

0535 

0536 

0537 

0538 

0539 

0540 

0541 

0542 

0543 

22x 

0544 

0545 

0546 

0547 

0548 

0549 

0550 

0551 

0552 

0553 

0554 

0555 

0556 

0557 

0558 

0559 

23x 

0560 

Q561 

0562 

0563 

0564 

0565 

0566 

0567 

0568 

0569 

0570 

0571 

0572 

0573 

0574 

0575 

2*x 

0576 

0577 

0578 

0579 

0580 

0581 

0582 

0583 

0584 

0585 

0S86 

0587 

0588 

0589 

0590 

0591 

25x 

0592 

0593 

0594 

0595 

0596 

0597 

0598 

0599 

0600 

0601 

0602 

0603 

0604 

0605 

0606 

0607 

26x 

0608 

0609 

0610 

0611 

0612 

0613 

0614 

0615 

0616 

0617 

0618 

0619 

0620 

0621 

0622 

0623 

27x 

0624 

0625 

0626 

0627 

0628 

0629 

0630 

0631 

0632 

0633 

0634 

0635 

0636 

0637 

0638 

0639 

28x 

0640 

0641 

0642 

0643 

0644 

0645 

0646 

0647 

0648 

0649 

0650 

0651 

0652 

0653 

0654 

0655 

29x 

0656 

0657 

0658 

0659 

0660 

0661 

0662 

0663 

0664 

0665 

0666 

0667 

0668 

0669 

0670 

0671 

2Ax 

0672 

0673 

0674 

0675 

0676 

0677 

0678 

0679 

0680 

0681 

0682 

0683 

0684 

0685 

0686 

0687 

2Bx 

0688 

0689 

0690 

0691 

0692 

0693 

0694 

0695 

0696 

0697 

0698 

0699 

0700 

0701 

0702 

0703 

2Cx 

0704 

0705 

0706 

0707 

0708 

0709 

0710 

0711 

0712 

0713 

0714 

0715 

0716 

0717 

0718 

0719 

2Dx 

0720 

0721 

0722 

0723 

0724 

0725 

0726 

0727 

0728 

0729 

0730 

0731 

0732 

0733 

0734 

0735 

2Ex 

0736 

0737 

0738 

0739 

0740 

0741 

0742 

0743 

0744 

0745 

0746 

0747 

0748 

0749 

0750 

0751 

2Fx 

0752 

0753 

0754 

0755 

0756 

0757 

0758 

0759 

0760 

0761 

0762 

0763 

0764 

0765 

0766 

0767 

30x 

0768 

0769 

0770 

0771 

0772 

0773 

0774 

0775 

0776 

0777 

0778 

0779 

0780 

0781 

0782 

0783 

31x 

0784 

0785 

0766 

07 e? 

0788 

0789 

0790 

0791 

0792 

0793 

0794 

0795 

0796 

0797 

0738 

0793 

32x 

0800 

0801 

0802 

0803 

0804 

0805 

0806 

0807 

0808 

0809 

0810 

0811 

0812 

0813 

0814 

0815 

33x 

0816 

0817 

0848 

0819 

0820 

0821 

0822 

0823 

0824 

0825 

0826 

0827 

0828 

0829 

0830 

0831 

34x 

0832 

0833 

0834 

0835 

0836 

0837 

0838 

0839 

0840 

0841 

0842 

0843 

0844 

0845 

0846 

0847 

35x 

0848 

0849 

0850 

0851 

0852 

0853 

0854 

0855 

0856 

0857 

0858 

0859 

0860 

0861 

0862 

0863 

36x 

0864 

0865 

0866 

0867 

0868 

0869 

0870 

0871 

0872 

0873 

0874 

0875 

0876 

0877 

0878 

0879 

37x 

0880 

0881 

0882 

0883 

0884 

0885 

0886 

0887 

0888 

0889 

0890 

0891 

0892 

0893 

0894 

0895 

38x 

0896 

0897 

0898 

0899 

0900 

0901 

0902 

0903 

0904 

0905 

0906 

0907 

0908 

0909 

0910 

0911 

39x 

0912 

0913 

0914 

0915 

0916 

0917 

0918 

0919 

0920 

0921 

0922 

0923 

0924 

0925 

0926 

0927 

3 Ax 

0928 

0929 

0930 

0931 

0932 

0933 

0934 

0935 

0936 

0937 

0938 

0939 

0940 

0941 

0942 

0943 

3Bx 

0944 

0945 

0946 

0947 

0948 

0949 

0950 

0951 

0952 

0953 

0954 

0955 

0956 

0957 

0958 

0959 

3Cx 

0960 

0961 

0962 

0963 

0964 

0965 

0966 

0967 

0968 

0969 

0970 

0971 

0972 

0973 

0974 

0975 

3Dx 

0976 

0977 

0978 

0979 

0980 

0981 

0982 

0983 

0984 

0985 

0986 

0987 

0988 

098-9 

0990 

0991 

3 Ex 

0992 

0993 

0994 

0995 

0996 

0997 

0998 

0999 

1000 

1001 

1002 

1003 

1004 

1005 

1006 

1007 

3Fx 

1008 

1009 

1010 

1011 

1012 

1013 

1014 

1015 

1016 

1017 

1018 

1019 

1020 

1021 

1022 

1023 
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x = 0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

«0x 

1024 

1025 

1026 

1027 

1028 

1029 

1030 

1031 

1032 

1033 

1034 

1035 

1036 

1037 

1038 

1039 


1040 

1041 

1042 

1043 

1044 

1045 

1046 

1047 

1048 

1049 

1050 

1051 

1052 

1053 

1054 

1055 

42x 

1056 

1057 

1058 

1059 

1060 

1061 

1062 

1063 

1064 

1065 

1066 

1067 

1068 

1069 

1070 

1071 

43x 

1072 

1073 

1074 

1075 

1076 

1077 

1078 

1079 

1080 

1081 

1082 

1083 

1084 

1085 

1086 

1087 


1088 

1089 

1090 

1091 

1092 

1093 

1094 

1095 

1096 

1097 

1098 

1099 

1100 

1101 

1102 

1103 

ini 

1104 

1105 

1106 

1107 

1108 

1109 

1110 

1111 

1112 

1113 

1114 

1115 

1116 

1117 

1118 

1119 

EQ3 

1120 

1121 

1122 

1123 

1124 

1125 

1126 

1127 

1128 

1129 

1130 

1131 

1132 

1133 

1134 

1135 

47x 

1136 

1137 

1138 

1139 

1140 

1141 

1142 

1143 

1144 

1145 

1146 

1147 

1148 

1149 

1150 

1151 

48x 

1152 

1153 

1154 

1155 

1156 

1157 

1158 

1159 

1160 

1161 

1162 

1163 

1164 

1165 

1166 

1167 

49x 

1168 

1169 

1170 

1171 

1172 

1173 

1174 

1175 

1176 

1177 

1178 

1179 

1180 

1181 

1182 

1183 

4 Ax 

1184 

1185 

1186 

1187 

1188 

1189 

1190 

1191 

1192 

1193 

1194 

1195 

1196 

1197 

1198 

1199 

4Bx 

1200 

1201 

1202 

1203 

1204 

1205 

1206 

1207 

1208 

1209 

1210 

1211 

1212 

1213 

1214 

1215 

4Cx 

1216 

1217 

1218 

1219 

1220 

1221 

1222 

1223 

1224 

1225 

1226 

1227 

1228 

1229 

1230 

1231 

40x 

1232 

1233 

1234 

1235 

1236 

1237 

1238 

1239 

1240 

1241 

1242 

1243 

1244 

1245 

1246 

1247 

4 Ex 

1248 

1249 

1250 

1251 

1252 

1253 

1254 

1255 

1256 

1257 

1258 

1259 

1260 

1261 

1262 

1263 

4Fx 

1264 

1265 

1266 

1267 

1268 

1269 

1270 

1271 

1272 

1273 

1274 

1275 

1276 

1277 

1278 

1279 

50x 

1280 

1281 

1282 

1283 

1284 

1285 

1286 

1287 

1288 

1289 

1290 

1291 

1292 

1293 

^294 

1295 

Six 

1296 

1297 

1298 

1299 

1300 

1301 

1302 

1303 

1304 

1305 

1306 

1307 

1308 

1309 

1310 

1311 

S2x 

1312 

1313 

1314 

1315 

1316 

1317 

1318 

1319 

1320 

1321 

1322 

1323 

1324 

1325 

1326 

1327 

53x 

1328 

1329 

1330 

1331 

1332 

1333 

1334 

1335 

1336 

1337 

1338 

1339 

1340 

1341 

1342 

1343 

54x 

1344 

1345 

1346 

1347 

1348 

1349 

1350 

1351 

1352 

1353 

1354 

1355 

1356 

1357 

1358 

1359 

55x 

1360 

1361 

1362 

1363 

1364 

1365 

1366 

1367 

1368 

1369 

1370 

1371 

1372 

1373 

1374 

1375 

56x 

1376 

1377 

1378 

1379 

1380 

1381 

1382 

1383 

1384 

1385 

1386 

1387 

1388 

1389 

1390 

1391 

57x 

1392 

1393 

1394 

1395 

1396 

1397 

1398 

1399 

1400 

1401 

1402 

1403 

1404 

1405 

1406 

1407 

58x 

1408 

1409 

1410 

1411 

1412 

1413 

1414 

1415 

1416 

1417 

1418 

1419 

1420 

1421 

1422 

1423 

59x 

1424 

1425 

1426 

1427 

1428 

1429 

1430 

1431 

1432 

1433 

1434 

1435 

1436 

1437 

1438 

1439 

SAx 

1440 

1441 

1442 

1443 

1444 

1445 

1446 

1447 

1448 

1449 

1450 

1451 

1452 

1453 

1454 

1455 

SBx 

1456 

1457 

1458 

1459 

1460 

1461 

1462 

1463 

1464 

1465 

1466 

1467 

1468 

1469 

1470 

1471 

5Cx 

1472 

1473 

1474 

1475 

1476 

1477 

1478 

1479 

1480 

1481 

1482 

1483 

1484 

1485 

1486 

1487 

SDx 

1488 

1489 

1490 

1491 

1492 

1493 

1494 

1495 

1496 

1497 

1498 

1499 

1500 

1501 

1502 

1503 

5 Ex 

1504 

1505 

1506 

1507 

1508 

1509 

1510 

1511 

1512 

1513 

1514 

1515 

1516 

1517 

1518 

1519 

S7x 

1520 

1521 

1522 

1523 

1524 

1525 

1526 

1527 

1528 

1529 

1530 

1531 

1532 

1533 

1534 

1535 

60x 

1536 

1537 

1538 

1539 

1540 

1541 

1542 

1543 

1544 

1545 

1546 

1547 

1548 

1549 

1550 

1551 

61x 

1552 

1553 

1554 

1555 

1556 

1557 

1558 

1559 

1560 

1561 

1562 

1563 

1564 

1565 

1566 

1567 

62x 

1568 

1569 

1570 

1571 

1572 

1573 

1574 

1575 

1576 

1577 

1578 

1579 

1580 

1581 

1582 

1583 

63x 

1584 

1585 

1586 

1587 

1588 

1589 

1590 

1591 

1592 

1593 

1594 

1595 

1596 

1597 

1598 

1599 

64x 

1600 

1601 

1602 

1603 

1604 

1605 

1606 

1607 

1608 

1609 

1610 

1611 

1612 

1613 

1614 

1615 

65x 

1616 

1617 

1618 

1619 

1620 

1621 

1622 

1623 

1624 

1625 

1626 

1627 

1628 

1629 

1630 

1631 

66x 

1632 

1633 

1634 

1635 

1636 

1637 

1638 

1639 

1640 

1641 

1642 

1643 

1644 

1645 

1646 

1647 

67x 

1648 

1649 

1650 

1651 

1652 

1653 

1654 

1655 

1656 

1657 

1658 

1659 

1660 

1661 

1662 

1663 

68x 

1664 

1665 

1666 

1667 

1668 

1669 

1670 

1671 

1672 

1673 

1674 

1675 

1676 

1677 

1678 

1679 

69x 

1680 

1681 

1682 

1683 

1684 

1685 

1686 

1687 

1688 

1689 

1690 

1691 

1692 

1693 

1694 

1695 

6Ax 

1696 

1697 

1698 

1699 

1700 

1701 

1702 

1703 

1704 

1705 

1706 

1707 

1708 

1709 

1710 

1711 

6Bx 

1712 

1713 

1714 

1715 

1716 

1717 

1718 

1719 

1720 

1721 

1722 

1723 

1724 

1725 

1726 

1727 

6Cx 

1728 

1729 

1730 

1731 

1732 

1733 

1734 

1735 

1736 

1737 

1738 

1739 

1740 

1741 

1742 

1743 

6Dx 

1744 

1745 

1746 

1747 

1748 

1749 

1750 

1751 

1752 

1753 

1754 

1755 

1756 

1757 

1758 

1759 

6 Ex 

1760 

1761 

1762 

1763 

1764 

1765 

1766 

1767 

1768 

1769 

1770 

1771 

1772 

1773 

1774 

1775 

6Fx 

1776 

1777 

1778 

1779 

1780 

1781 

1782 

1783 

1784 

1785 

1786 

1787 

1788 

1789 

1790 

1791 

70x 

1792 

1793 

1794 

1795 

179 6 

1797 

1798 

1799 

1800 

1801 

1802 

1803 

1804 

1805 

1806 

1807 

71x 

1808 

1809 

1810 

1811 

1812 

1813 

1814 

1815 

1816 

1817 

1818 

1819 

1820 

1821 

1822 

1823 

72x 

1824 

1825 

1826 

1827 

1828 

1829 

1830 

1831 

1832 

1833 

1834 

1835 

1836 

1837 

1838 

1839 

73x 

1840 

1841 

1842 

1843 

1844 

1845 

1846 

1847 

1848 

1849 

1850 

1851 

1852 

1853 

1854 

1855 

74x 

1856 

1857 

1858 

1859 

1860 

1861 

1862 

1863 

1864 

1865 

1866 

1867 

1868 

1869 

1870 

1871 

75x 

1872 

1873 

1874 

1875 

1876 

1877 

1878 

1879 

1880 

1881 

1882 

1883 

1884 

1885 

1886 

1887 

76x 

1888 

1889 

1890 

1891 

1892 

1893 

1894 

1895 

1896 

1897 

1898 

1899 

1900 

1901 

1902 

1903 

77x 

1904 

1905 

1906 

1907 

1908 

1909 

1910 

1911 

1912 

1913 

1914 

1915 

1916 

1917 

1918 

1919 

78x 

1920 

1921 

1922 

1923 

1924 

1925 

1926 

1927 

1928 

1929 

1930 

1931 

1932 

1933 

1934 

1935 

79x 

1936 

1S37 

1938 

1939 

1940 

1941 

1942 

1943 

1944 

1945 

1946 

1947 

1948 

1949 

1950 

1951 

7 Ax 

1952 

1953 

1954 

1955 

1956 

1957 

1958 

1959 

1960 

1961 

1962 

1963 

1964 

1965 

1966 

1967 

7Bx 

1968 

1969 

1970 

1971 

1972 

1973 

1974 

1975 

1976 

1977 

1978 

1979 

1980 

1981 

1982 

1983 

7Cx 

1984 

1985 

1986 

1987 

1988 

1989 

1990 

1991 

1992 

1993 

1994 

1995 

1996 

1997 

1998 

1999 

7Dx 

2000 

2001 

2002 

2003 

2004 

2005 

2006 

2007 

2008 

2009 

2010 

2011 

2012 

2013 

2014 

2015 

7Ex 

2016 

2017 

2018 

2019 

2020 

2021 

2022 

2023 

2024 

2025 

2026 

2027 

2028 

2029 

2030 

2031 

7Fx 

2032 

2033 

2034 

2035 

2036 

2037 

2038 

2039 

2040 

2041 

2042 

2043 

2044 

2045 

2046 

2047 
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X = 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

80x 


2048 

2049 

2050 

2051 

2052 

2053 

2054 

2055 

2056 

2057 

2058 

2059 

2060 

2061 

2062 

2063 

81x 


2064 

2065 

2066 

2067 

2068 

2069 

2070 

2071 

2072 

2073 

2074 

2075 

2076 

2077 

2078 

2079 

82x 


2080 

2081 

2082 

2083 

2084 

2085 

2086 

2087 

2088 

2089 

2090 

2091 

2092 

2093 

2094 

2095 

33x 


2096 

2097 

2098 

2099 

2100 

2101 

2102 

2103 

2104 

2105 

2106 

2107 

2108 

2109 

2110 

2111 

84x 


2112 

2113 

2114 

2115 

2116 

2117 

2118 

2119 

2120 

2121 

2122 

2123 

2124 

2125 

2126 

2127 

85x 


2128 

2129 

2130 

2131 

2132 

2133 

2134 

2135 

2136 

2137 

2138 

2139 

2140 

2141 

2142 

2143 

86x 


2144 

2145 

2146 

2147 

2148 

2149 

2150 

2151 

2152 

2153 

2154 

2155 

2156 

2157 

2158 

2159 

87x 


2160 

2161 

2162 

2163 

2164 

2165 

2166 

2167 

2168 

2169 

2170 

2171 

2172 

2173 

2174 

2175 

88x 


2176 

2177 

2178 

2179 

2180 

2181 

2182 

2183 

2184 

2185 

2186 

2187 

2188 

2189 

2190 

2191 

89x 


2192 

2193 

2194 

2195 

2196 

2197 

2198 

2199 

2200 

2201 

2202 

2203 

2204 

2205 

2206 

2207 

0|» 


oono 

OOAO 

ooirt 

50 1 1 

5515 

5515 

501 ll 

551 e 

551C 

?? «7 

9010 





5001 

8Bx 


2224 

2225 

2226 

2227 

2228 

2229 

2230 

2231 

2232 

2233 

2234 

2235 

2236 

2237 

2238 

2239 

8Cx 


2240 

2241 

2242 

2243 

2244 

2245 

2246 

2247 

2248 

2249 

2250 

2251 

2252 

2253 

2254 

2255 

8Dx 


2256 

2257 

2258 

2259 

2260 

2261 

2262 

2263 

2264 

2265 

2266 

2267 

2268 

2269 

2270 

2271 

8Ex 


2272 

2273 

2274 

2275 

2276 

2277 

2278 

2279 

2280 

2281 

2282 

2283 

2284 

2285 

2286 

2287 

8Fx 


2288 

2289 

2290 

2291 

2292 

2293 

2294 

2295 

2296 

2297 

2298 

2299 

2300 

2301 

2302 

2303 

90x 


2304 

2305 

2306 

2307 

2308 

2309 

2310 

2311 

2312 

2313 

2314 

2315 

2316 

2317 

2318 

2319 

91x 


2320 

2321 

2322 

2323 

2324 

2325 

2326 

2327 

2328 

2329 

2330 

2331 

2332 

2333 

2334 

2335 

92x 


2336 

2337 

2338 

2339 

2340 

2341 

2342 

2343 

2344 

2345 

2346 

2347 

2348 

2349 

2350 

2351 

93x 


2352 

2353 

2354 

2355 

2356 

2357 

2358 

2359 

2360 

2361 

2362 

2363 

2364 

2365 

2366 

2367 

94x 


2368 

2369 

2370 

2371 

2372 

2373 

2374 

2375 

2376 

2377 

2378 

2379 

2380 

2381 

2382 

2383 

95x 


2384 

2385 

2386 

2387 

2388 

2389 

2390 

2391 

2392 

2393 

2394 

2395 

2396 

2397 

2398 

2399 

96x 


2400 

2401 

2402 

2403 

2404 

2405 

2406 

2407 

2408 

2409 

2410 

2411 

2412 

2413 

2414 

2415 

97x 


2416 

2417 

2418 

2419 

2420 

2421 

2422 

2423 

2424 

2425 

2426 

2427 

2428 

2429 

2430 

2431 

98x 


2432 

2433 

2434 

2435 

2436 

2437 

2438 

2439 

2440 

2441 

2442 

2443 

2444 

2445 

2446 

2447 

99x 


2448 

2449 

2450 

2451 

2452 

2453 

2454 

2455 

2456 

2457 

2458 

2459 

2460 

2461 

2462 

2463 

9Ax 


2464 

2465 

2466 

2467 

2468 

2469 

2470 

2471 

2472 

2473 

2474 

2475 

2476 

2477 

2478 

2479 

9Bx 


2480 

2481 

2482 

2483 

2484 

2485 

2486 

2487 

2488 

2489 

2490 

2491 

2492 

2493 

2494 

2495 

9Cx 


2496 

2497 

2498 

2499 

2500 

2501 

2502 

2503 

2504 

2505 

2506 

2507 

2508 

2509 

2510 

2511 

9Dx 


2512 

2513 

2514 

2515 

2516 

2517 

2518 

2519 

2520 

2521 

2522 

2523 

2524 

2525 

2526 

2527 

9Ex 


2528 

2529 

2530 

2531 

2532 

2533 

2534 

253 5 

2536 

2537 

2538 

2539 

2540 

2541 

2542 

2543 

9Fx 


2544 

2545 

2546 

2547 

2548 

2549 

2550 

2551 

2552 

2553 

2554 

2555 

2556 

2557 

2558 

2559 

AOx 


2560 

2561 

2562 

2563 

2564 

2565 

2566 

2567 

2568 

2569 

2570 

2571 

2572 

2573 

2574 

2575 

Alx 


2576 

2577 

2578 

2579 

2580 

2581 

2582 

2583 

2584 

2585 

2586 

2587 

2588 

2589 

2590 

2591 

A2x 


2592 

2593 

2594 

2595 

2596 

2597 

2598 

2599 

2600 

2601 

2602 

2603 

2604 

2605 

2606 

2607 

A3x 


2608 

2609 

2610 

2611 

2612 

2613 

2614 

2615 

2616 

2617 

2618 

2619 

2620 

2621 

2622 

2623 

A4x 


2624 

2625 

2626 

2627 

2628 

2629 

2630 

2631 

2632 

2633 

2634 

2635 

2636 

2637 

2638 

2639 

A5x 


2640 

2641 

2642 

2643 

2644 

2645 

2646 

2647 

2648 

2649 

2650 

2651 

2652 

2653 

2654 

2655 

A6x 


2656 

2657 

2658 

2659 

2660 

2661 

2662 

2663 

2664 

2665 

2666 

2667 

2668 

2669 

2670 

2671 

A7x 


2672 

2673 

2674 

2675 

2676 

2677 

2678 

2679 

2680 

2681 

2682 

2683 

2684 

2685 

2686 

2687 

A8x 


2688 

2689 

2690 

2691 

2692 

2693 

2694 

2695 

2696 

2697 

2698 

2699 

2700 

2701 

2702 

2703 

A9x 


2704 

2705 

2706 

2707 

2708 

2709 

2710 

2711 

2712 

2713 

2714 

2715 

2716 

2717 

2718 

2719 

AAx 


2720 

2721 

2722 

2723 

2724 

2725 

2726 

2727 

2728 

2729 

2730 

2731 

2732 

2733 

2734 

2735 

ABx 


2736 

2737 

2738 

2739 

2740 

2741 

2742 

2743 

2744 

2745 

2746 

2747 

2748 

2749 

2750 

2751 

ACx 


2752 

2753 

2754 

2755 

2756 

2757 

2758 

2759 

2760 

2761 

2762 

2763 

2761' 

?765 

2766 

2767 

ADx 


2768 

2769 

2770 

2771 

2772 

2773 

2774 

2775 

2776 

2777 

2778 

2779 

2780 

2781 

2782 

2783 

AEx 


2784 

2785 

2786 

2787 

2788 

2789 

2790 

2791 

2792 

2793 

2794 

2795 

2796 

2797 

2798 

2799 

AFx 


2800 

2801 

2802 

2803 

2804 

2805 

2806 

2807 

2808 

2809 

2810 

2811 

2812 

2813 

2814 

2815 

BOx 


2816 

281 ? 

2818 

2819 

2820 

2821 

2822 

2823 

2824 

2825 

2826 

2827 

2828 

2829 

2830 

2831 

BIx 


2832 

2833 

2834 

2835 

2836 

2837 

2838 

2839 

2840 

2841 

2842 

2843 

2844 

2845 

2846 

2847 

B2x 


2848 

2849 

2850 

2851 

2852 

2853 

2854 

2855 

2856 

2857 

2858 

2859 

2860 

2861 

2862 

2863 

B3x 


2864 

2865 

2866 

2867 

2868 

2869 

2870 

2871 

2872 

2873 

2874 

2875 

2876 

2877 

2878 

2679 

B4x 


2880 

2881 

2882 

2883 

2884 

2885 

2886 

2887 

2888 

2889 

2890 

2891 

2892 

2893 

2894 

2895 

B5x 


2896 

2897 

2898 

2899 

2900 

2901 

2902 

2903 

2904 

2905 

2906 

2907 

2908 

2909 

2910 

2911 

B6x 


2912 

2913 

2914 

2915 

2916 

2917 

2918 

2919 

2920 

2921 

2922 

2923 

2924 

2925 

2926 

2927 

B7x 


2928 

2929 

2930 

2931 

2932 

2933 

2934 

2935 

2936 

2937 

2938 

2939 

2940 

2941 

2942 

2943 

B8x 


2944 

2945 

2946 

2947 

2948 

2949 

2950 

2951 

2952 

2953 

2954 

2955 

2956 

2957 

2958 

2959 

B9x 


2960 

2961 

2962 

2963 

2964 

2965 

2966 

2967 

2968 

2969 

2970 

2971 

2972 

2973 

2971* 

2975 

BAx 


2976 

2977 

2978 

2979 

2980 

2981 

2982 

2983 

2984 

2985 

2986 

2987 

2988 

2989 

2990 

2991 

BBx 


2992 

2993 

2994 

2995 

2996 

2997 

2998 

2999 

3000 

3001 

3002 

3003 

3004 

3005 

3006 

3007 

BCx 


3008 

3009 

3010 

3011 

3012 

3013 

3014 

3015 

3016 

3017 

3018 

3019 

3020 

3021 

3022 

3023 

BDx 


3024 

3025 

3026 

3027 

3028 

3029 

3030 

3031 

3032 

3033 

3034 

3035 

3036 

3037 

3038 

3039 

BEx 


3040 

3041 

3042 

3043 

3044 

3045 

3046 

3047 

3048 

3049 

3050 

3051 

3052 

3053 

3054 

3055 

BFx 


3056 

3057 

3058 

3059 

3060 

3061 

3062 

3063 

3064 

3065 

3066 

3067 

3068 

3069 

3070 

3071 


118 




x = 0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

COx 

3072 

3073 

3074 

3075 

3076 

3077 

3078 

3079 

3080 

3081 

3082 

3083 

3084 

JUOO 

3086 

3087 

Clx 

3088 

3089 

3090 

3091 

3092 

3093 

3094 

3095 

3096 

3097 

3098 

3099 

3100 

3101 

3102 

3103 

C2x 

3104 

3105 

3106 

3107 

3108 

3109 

3110 

3111 

3112 

3113 

3114 

3115 

3116 

3117 

3118 

3119 

C3x 

3120 

3121 

3122 

3123 

3124 

3125 

3126 

3127 

3128 

3129 

3130 

3131 

3132 

3133 

3134 

3135 

C4x 

3136 

3137 

3138 

3139 

3140 

3141 

3142 

3143 

3144 

3145 

3146 

3147 

3148 

3149 

3150 

3151 

C5x 

3152 

3153 

3154 

3155 

3156 

3157 

3158 

3159 

3160 

3161 

3162 

3163 

3164 

3165 

3166 

3167 

C6x 

3168 

3169 

3170 

3171 

3172 

3173 

3174 

3175 

3176 

3177 

31-78 

3179 

3180 

3181 

3182 

3183 

C7x 

3184 

3185 

3186 

3187 

3188 

3189 

3190 

3191 

3192 

3193 

3194 

3195 

3196 

3197 

3198 

3199 

C8x 

3200 

3201 

3202 

3203 

3204 

3205 

3206 

3207 

3208 

3209 

3210 

3211 

3212 

3213 

3214 

3215 

C9x 

3216 

3217 

3218 

3219 

3220 

3221 

3222 

3223 

3224 

3225 

3226 

3227 

3228 

3229 

3230 

3231 

CAx 

3232 

3233 

3234 

32 35 

3236 

3237 

3238 

3239 

3240 

3241 

3242 

3243 

3244 

3245 

3246 

3247 

CBx 

3248 

3249 

3250 

3251 

3252 

3253 

3254 

3255 

3256 

3257 

3258 

3259 

3260 

3261 

3262 

3263 

CCx 

3264 

3265 

3266 

3267 

3268 

3269 

3270 

3271 

3272 

3273 

3274 

3275 

3276 

3277 

3278 

3279 

CDx 

3280 

3281 

3282 

3283 

3284 

3285 

3286 

3287 

3288 

3289 

3290 

3291 

3292 

3293 

3294 

3295 

CEx 

3296 

3297 

3298 

3299 

3300 

3301 

3302 

3303 

3304 

3305 

3306 

3307 

3308 

3309 

3310 

3311 

CFx 

3312 

3313 

3314 

3315 

3316 

3317 

3318 

3319 

3320 

3321 

3322 

3323 

3324 

3325 

3326 

3327 

DOx 

3328 

3329 

3330 

3331 

3332 

3333 

3334 

3335 

3336 

3337 

3338 

3339 

3340 

3341 

3342 

3343 

Dlx 

3344 

3345 

3346 

3347 

3348 

3349 

3350 

3351 

3352 

3353 

3354 

3355 

3356 

3357 

3358 

3359 

D2x 

3360 

3361 

3362 

3363 

3364 

3365 

3366 

3367 

3368 

3369 

3370 

3371 

3372 

3373 

3374 

3375 

D3x 

3376 

3377 

3378 

3379 

3380 

3381 

3382 

3383 

3384 

3385 

3386 

3387 

3388 

3389 

3390 

3391 

D4x 

3392 

3393 

3394 

3395 

3396 

3397 

3398 

3399 

3400 

3401 

3402 

3403 

3404 

3405 

3406 

3407 

D5x 

3408 

3409 

3410 

34 11 

3412 

3413 

3414 

3415 

3416 

3417 

3418 

3419 

3420 

3421 

3422 

3423 

D6x 

3424 

3425 

3426 

3427 

3428 

3429 

3430 

3431 

3432 

3433 

3434 

3435 

3436 

3437 

3438 

3439 

D7x 

3440 

3441 

3442 

3443 

3444 

3445 

3446 

3447 

3448 

3449 

3450 

3451 

3452 

3453 

3454 

3455 

D8x 

3456 

3457 

3458 

34 59 

3460 

3461 

3462 

3463 

3464 

3465 

3466 

3467 

3468 

3469 

3470 

3471 

D9x 

3472 

3473 

3474 

34 75 

3476 

3477 

3478 

3479 

3480 

3481 

3482 

3483 

3484 

3485 

3486 

3487 

DAx 

3488 

3489 

3490 

3491 

3492 

3493 

3494 

3495 

3496 

3497 

3498 

3499 

3500 

3501 

3502 

3503 

DBx 

3504 

3505 

3506 

3507 

3508 

3509 

3510 

3511 

3512 

3513 

3514 

3515 

3516 

3517 

3518 

3519 

DCx 

3520 

3521 

3522 

3523 

3524 

3525 

3526 

3527 

3528 

3529 

3530 

3531 

3532 

3533 

3534 

3535 

DDx 

3536 

3537 

3538 

3539 

3540 

3541 

3542 

3543 

3544 

3545 

3546 

3547 

3548 

3549 

3550 

3551 

DEx 

3552 

3553 

3554 

3555 

3556 

3557 

3558 

3559 

3560 

3561 

3562 

3563 

3564 

3565 

3566 

3567 

DFx 

3568 

3569 

3570 

3571 

3572 

3573 

3574 

3575 

3576 

3577 

3578 

3579 

3580 

3581 

3582 

3583 

EOx 

3584 

3585 

3586 

3587 

3588 

3589 

3590 

3591 

3592 

3593 

3594 

3595 

3596 

3597 

3598 

3599 

Elx 

3600 

3601 

3602 

3603 

3604 

3605 

3606 

3607 

3608 

3609 

3610 

3611 

3612 

3613 

3614 

3615 

E2x 

3616 

3617 

3618 

3619 

3620 

3621 

3622 

3623 

3624 

3625 

3626 

3627 

3628 

3629 

3630 

3631 

E3x 

3632 

3633 

3634 

3635 

3636 

3637 

3638 

3639 

3640 

3641 

3642 

3643 

3644 

3645 

3646 

3647 

E4x 

3648 

3649 

3650 

3651 

3652 

3653 

3654 

3655 

3656 

3657 

3658 

3659 

3660 

3661 

3662 

3663 

E5x 

3664 

3665 

3666 

3667 

3668 

3669 

3670 

3671 

3672 

3673 

3674 

3675 

3676 

3677 

3678 

3679 

E6x 

3680 

3681 

3682 

36 83 

3684 

3685 

3686 

3687 

3688 

3689 

3690 

3691 

3692 

3693 

3694 

3695 

E7x 

3696 

3697 

3698 

3699 

3700 

3701 

3702 

3703 

3704 

3705 

3706 

3707 

3708 

3709 

3710 

3711 

• 

E8x 

3712 

3713 

3714 

3715 

3716 

3717 

3718 

3719 

3720 

3721 

3722 

3723 

3724 

3725 

3726 

3727 

E9x 

3728 

3729 

3730 

3731 

3732 

3733 

3734 

3735 

3736 

3737 

3738 

3739 

3740 

3741 

3742 

3743 

EAx 

3744 

3745 

3746 

3747 

3748 

3749 

3750 

3751 

3752 

3753 

3754 

3755 

3756 

3757 

3758 

3759 

EBx 

3760 

3761 

3762 

3763 

3764 

3765 

3766 

3767 

3768 

3769 

3770 

3771 

3772 

3773 

3774 

3775 

ECx 

3776 

3777 

3778 

3779 

3780 

3781 

3782 

3783 

3784 

3785 

3786 

3787 

3788 

3789 

3790 

3791 

EDx 

3792 

3793 

3794 

3795 

3796 

3797 

3798 

3799 

3800 

3801 

3802 

3803 

3804 

3805 

3806 

3807 

EEx 

3808 

3809 

3810 

3811 

3812 

3813 

3814 

3815 

3816 

3817 

3818 

3819 

3820 

3821 

3822 

3823 

EFx 

3824 

3825 

3826 

3827 

3828 

3829 

3830 

3831 

3832 

3833 

3834 

3835 

3836 

3837 

3838 

3839 

FOx 

3840 

3841 

3842 

3843 

3844 

3845 

3846 

3847 

3848 

3849 

3850 

3851 

3352 

3853 

3854 

3855 

Fix 

3856 

3857 

3858 

3859 

3860 

3861 

3862 

3863 

3864 

3865 

3866 

3867 

3868 

3869 

3870 

3871 

F2x 

3872 

3873 

3874 

3875 

3876 

3877 

3878 

3879 

3880 

3881 

3882 

3883 

3884 

3885 

3886 

3887 

F3x 

3888 

3889 

3890 

3891 

3892 

3893 

3894 

3895 

3896 

3897 

3898 

3899 

3900 

3901 

3902 

3903 

F4x 

3904 

3905 

3906 

3907 

3908 

3909 

3910 

3911 

3912 

3913 

3914 

3915 

3916 

3917 

3918 

3919 

F5x 

3920 

3921 

3922 

3923 

3924 

3925 

3926 

3927 

3928 

3929 

3930 

3931 

3932 

3933 

3934 

3935 

F6x 

3936 

3937 

3938 

3939 

3940 

3941 

3942 

3943 

3944 

3945 

3946 

3947 

3948 

3949 

3950 

3951 

F7x 

3952 

3953 

3954 

3955 

3956 

3957 

3958 

3959 

3960 

3961 

3962 

3963 

3964 

3965 

3966 

3967 

F8x 

3968 

3969 

3970 

3971 

3972 

3973 

3974 

3975 

3976 

3977 

3978 

3979 

3980 

3981 

3982 

3983 

F9x 

3984 

3985 

3986 

3987 

3988 

3989 

3990 

3991 

3992 

3993 

3994 

3995 

3996 

3997 

3998 

3999 

FAX 

4000 

4001 

4002 

4003 

4004 

4005 

4006 

4007 

4008 

4009 

4010 

4011 

4012 

4013 

4014 

4015 

FBx 

4016 

4017 

4018 

4019 

4020 

4021 

4022 

4023 

4024 

4025 

4026 

4027 

4028 

4029 

4030 

4031 

FCx 

4032 

4033 

4034 

4035 

4036 

4037 

4038 

4039 

4040 

4041 

4042 

4043 

4044 

4045 

4046 

4047 

FDx 

4048 

4049 

4050 

4051 

4052 

4053 

4054 

4055 

4056 

4057 

4058 

4059 

4060 

4061 

4062 

4063 

FEx 

4064 

4065 

4066 

4067 

4068 

4069 

4070 

4071 

4072 

4073 

4074 

4075 

4076 

4077 

4078 

4079 

FFx 

4080 

4081 

4082 

4083 

4084 

4085 

4086 

4087 

4088 

4089 

4090 

4091 

4092 

4093 

4094 

4095 
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Appendix C. Machine Instruction Format 


T-T 

I 

AFFLICAELE INSTRUCTIONS j 

-^ 

I 

I 

I 

All RR instructions | 

except ECR, SPM, and SVC| 


I— 


BASIC MACHINE FORMAT 


- + 


ASSEMBLER CFERAND 
FIELD FORMAT 


j J —— — ,| 1 

I 8 I 4 | a | 

|Operation| | | 

| Code |R1|R2| 

L_X-X-J 


RR 




RX 


R1, R2 


8 


I v -a 4- 4 nr» til 

| Code |M1J R21 

L_X X i 


I 8 |4 | | 

|Operation | | | 

| Code |R11 | 

L-JL X J 

I 8 ~T 8 1 

JOperation! | 

j Code j I j 

l _j_J 


R1 


SPM 


SVC 


- + 


(See Notes 1, 6, 8, and 9) 


r -r—r— t— r —i 

! 8 I 4 | 4 | 4 | 121 

|Operation! till 
j Code j R1j X2 j B2j D2| 

L_X_X_X_X_J 

r-r— t —t—t— i 

} 8 |4 |4 |4 12 | 

|Operation! 1111 
| Code |M 1 j X2 j B2|D2| 

L-X_X_X-X-J 


I—+ 


- + 


R1,D2 (X2 ,B2) 

R1,D2 (,B2) 

R1,S2 (X2) 

R1, S2 

M1,E2, (X2,B2) 

M1,D2 (,B2) 

Ml # S2 (X2) 

Ml, S2 

(See Notes 1, 6, 8, and 9) 


All RX instructions 
except EC 


EC 


RS 


r-T-T-T-T- 1 

I 8 I 4 J 4 I 4 | 121 
(Operation! | j I I 
j Code |R1|R3|B2|D2J 

L_X_X_X_X_J 


I 8 (4 J (4 J12| 

(Operation! j | | | 

| Code |R1J |B 21D21 

L_X_X-X_X_i 

r- r— t — t —r—i 

I 8 J 4 | 4 (4 | 12J 

|Operation | (III 
| Code |R1JM3|B2|D2J 

L_X-X-X-X-1 


R1,R3,D2 (B2) 
R1,R3,S2 


R1 ,D2 (B2) 
R1,S2 


EXH,EXLE,LM,STM,LCTL, 

STCTL 


All shift instructions j 


R1,M3,D2 (B2) 

R1,M3,S2 

(See Notes 1-3, 7, 8, 
and 9) 


ICM,STCM,CLM 
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I -T 


SI 


H-+ 


ss 


BASIC MACHINE FORMAT 

j ASSEMBLER OPERAND 

| FIELD FORMAT 


(APPLICABLE INSTRUCTIONS 

.j.__ 

1 8 | 8 |4 | 12J 

jOperation | ( | | 

| Code | 12 | B11D11 

’r " ... J ’■ " " * ' ■“ 

1 

|D1 (B1) ,12 
j Si,12 

1 

! 

i 


1 

|All SI instructions 

(except those listed 

(for other SI formats 

1 

I 

1 

r*- t- --i 

1 8 | |4 I 12! 

| Operation) | | | 

! Code | | B11D11 

i 

1 

j D1 (B1) 
j SI 

1 

1 


1 

1 

(LPSW,SSM,TIO,TCH 

(TS 

1 

i 

r— -—~- ~1 1 - 1 

I 16 |4 |12| 

| Two-byte j j | 

jOperation Code |B1|D1| 

I 

1 

1 D1 (Bl) 

| SI 

j (See Notes 2, 3, 6, 
j and 10) 

-4- 

7, 8, 

1 

1 

JSCK,STCK,STIDP,STIDC, 
(SIO, SIOF, HIO, HDV 

1 

1 

.1 _ 


r — 

i 


i 

r — r—r—r—i-r i i 

i 8 14 | 4 | 4 | 121 4 | 12] 

| Operation! | | | | ! ) 

J Code |LI]L2|B1(D1(B2(D2| 

1 

1 

jD1 (L1,B1) ,D2 (L2,B2) 

| SI (LI) ,S2 (L2) 

1 

1 


1 

J PACK,UNPK,MVO,AP, 
(CP,DP,MP,SP,ZAP 

1 

1 

1 ~T 1 1 T 1 1 

| 8 | 8 | 4’ | 12J 4 J 12J 

| Operation! 1 1 1 1 ! 

] Code J L |B11011 B2( D2| 

1 

1 

| D1 (L,B1) ,D2 (B2) 

! SI (L) ,S2 

j (See Notes 2, 3, 5, 

( 

and 7) 

1 

1 

jNC,OC,XC,CLC,MVC,MVN, 

j MVZ,TR,TRT,ED,EDMK 

1 

fl 

r- t— r— t— i- 1 - 1 - 1 

| 8 1 4 14 | 4 | 12| 4 | 12| 

(Operation! | | | | | | 

| Code |L1|I3|B1!D1|B2|D2] 

1 

jD1 (L1,B1) ,D2 (B2) ,13 
JS1 (LI) ,S2,I3 
|S1,S2,I3 

j (See Notes 2, 3, 5, 

| and 10) 

6, 7, 

1 

1 

(SRP 

1 

1 

1 


H 
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Notes for Appendix C . 


1. R1, R2, and R3 are absolute expressions that specify general or floating-point 
registers. The general register numbers are 0 through 15; floating-point register 
numbers are 0, 2, 4, and 6. 

2. D1 and D2 are absolute expressions that specify displacements. A value of 0-4095 
may be specified. 

3* B1 and B2 are absolute expressions that specify base registers. Register numbers 
0-15. 

4. X2 is an absolute expression that specifies an index register. Register numbers 
are 0-15. 

5. L, LI, and L2 are absolute expressions that specify field lengths. An L expression 
can specify a value of 1—256. LI and L2 expressions can specify a value of 1—16. 

In all cases, the assembled value will be one less than the specified value. 

6. I, 12, and 13 are absolute expressions that provide immediate data. The value of I 

and 12 may be 0-255. The value of 13 may be 0-9. 

7. SI and S2 are absolute or relocatable expressions that specify an address. 

8. RR, RS, and SI instruction fields that are blank under BASIC MACHINE FORMAT are not 
examined during instruction execution. The fields are not written in the symbolic 
operand, but are assembled as binary zeros. 

9. Ml and M3 specify a 4-bit mask. 

10. In IBM System/370 the H10, HDV, SIO, and SIOF operation codes occupy one byte and 
the low order bit of the second byte. In all other systems the HIO and SIO 
operation codes occupy only the first byte of the instruction. 
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Appendix D. Machine Instruction Mnemonic Operation Codes 


Figure 14 lists all machine operation codes 
and their associated assembler instructions 
and mnemonics in operation code order. 

Figure 16 contains the mnemonic 
operation codes for all machine 
instructions that can be represented in 
assembler language, including extended 
mnemonic operation codes. it is in 
alphabetic order by instruction. Indicated 
for each instruction are both the mnemonic 
and machine operation codes, explicit and 
implicit operand formats, program 
interruptions possible, and condition code 
set. 

The column headings in this appendix and 
the information each column provides 
follow. 

Instructions . This column contains the 
name of the instruction associated with the 
mnemonic operation code. 

Mnemonic Operation Code . This column gives 
the mnemonic operation code for the machine 
instruction. This is written in the 
operation field when coding the 
instruction. 

Machine Operation Code . This column 
contains the hexadecimal equivalent of the 
actual machine operation code. The 
operation code will appear in this form in 
most storage dumps and when displayed on 
the system control panel. For extended 
mnemonics, this column also contains the 
mnemonic code of the instruction from which 
the extended mnemonic is derived. 

Operand Format . This column shows the 
symbolic format of the operand field in 
both explicit and implicit form. For both 
forms, R1, R2, and R3 indicate general 


registers in operands one, two, and three 
respectively. X2 indicates a general 
register used as an index register in the 
second operand. Instructions which require 
an index register (X2) but are not to be 
indexed are shown with a 0 replacing X2. 

L, LI, and L2 indicate lengths for either 
operand, operand one, and operand two 
respectively. Ml and M3 indicate four bit 
masks in operands one and three. I, 12, 
and 13 indicate immediate data eight bits 
long (I and 12) , or four bits long (13) . 

For the explicit format, D1 and D2 
indicate a displacement and B1 and B2 
indicate a base register for operands one 
and two. 

For the implicit format, D1, B1, and D2, 
B2 are replaced by SI and S2 which indicate 
a storage address in operands one and two. 


Type of Instruction . This column gives the 
basic machine format of the instruction 
(RR, RX, SI, or SS) . If an instruction is 
included in a special feature or is an 
extended mnemonic, this is also indicated. 

Program Interruptions Possible . This 
column indicates the possible program 
interrupts for this instruction. The 
abbreviations used are: A-Addressing, 

S-Specification, Ov-Overflow, P-Protection, 
Op-Operation (if feature is not installed) 
and Other-other interruptions which are 
listed. The type of overflow is indicated 
by: D-Decimal, E-Exponent, or F-Fixed 

Point. 

Condition Code Set . The condition set as a 
result of this instruction is indicated in 
this column. (See legend following the 
figure.) 
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f-- 

j RR Format | 


[ Operation 
| Code 

— r~ m 
1 

1 

Name 

— T — 
1 

1 

Mnemonic 

—T 

1 

1 

_L . 

- -1 

Remarks | 

1 - 

| 00 

1 oi 

1 02 
« rva 

—-j- - 
1 

1 

1 

i 


- j. — 

1 

1 

1 

1 


—r 

1 

1 

1 

l 


i 04 

1 

Set Program Mask 

i 

SPM 

i 


J 05 

1 

Branch and Link 

i 

BALR 

i 


J 06 

1 

Branch on Count 

i 

BCTR 

i 


| 07 

1 

Branch on Condition 

i 

BCR 

i 


| 08 

1 

Set Storage Key 

i 

SSK 

i 


| 09 

1 

Insert Storage Key 

i 

ISK 

! 


1 A TV 

l 


i 

q\7P 

i 

i 

j 0B 
| OC 
| 0D 

i 

1 

1 

1 


i 

i 

i 

i 


a 

1 

1 

1 

l 

j OE 

1 

1 

1 

Move Long 

i 

i 

MVCL 

1 

1 

System/370| 
only ! 

j OF 

1 

1 

1 

Compare Logical Long 

i 

i 

CLCL 

I 

1 

System/370 j 
only j 

1 io 

1 

Load Positive 

i 

LPR 

1 


1 11 

1 

Load Negative 

i 

LNR 

1 


J 12 

1 

Load and Test 

i 

LTR 

1 


1 13 

1 

Load Complement 

i 

LCR 

1 


| 14 

1 

AND 

i 

NR 

1 


1 15 

1 

Compare Logical 

i 

CLR 

1 


1 16 

1 

OR 

i 

OR 

I 


1 17 

1 

Exclusive OR 

i 

XR 

1 


1 18 

1 

Load 

i 

LR 

1 


1 19 

1 

Compare 

i 

CR 

1 


1 1A 

1 

Add 

i 

AR 

1 


1 IB 

1 

Subtract 

i 

SR 

1 


| 1C 

1 

Multiply 

i 

MR 

1 


1 ID 

1 

Divide 

i 

DR 

1 


1 IE 

1 

Add Logical 

i 

ALR 

1 


j IF 

1 

Subtract Logical 

i 

SLR 

1 


1 20 

1 

Load Positive (Long) 

i 

LPDR 

1 


1 21 

1 

Load Negative (Long) 

i 

LNDR 

1 


1 22 

1 

Load and Test (Long) 

i 

LTDR 

1 


1 23 

1 

Load Complement (Long) 

i 

LCDR 

1 


| 24 

1 

Halve (Long) 

i 

HDR 

1 


1 25 

1 

1 

1 

Load Rounded (Extended to Long) 

i 

i 

LRDR 

1 

1 

85,195, | 

System/370 j 

j 26 
i 

1 

i 

Multiply (Extended) 

i 

a 

i 

MXR 

1 

l 

1 

85,195, | 

System/370} 

j 27 

1 

1 

1 

Multiply (Long to Extended) 

1 

1 

MXDR 

1 

1 

85,195 | 

System/370 j 

j 28 

1 

Load (Long) 

1 

LDR 

1 


j 29 

1 

Compare (Long) 

1 

CDR 

! 


| 2A 

1 

Add Normalized (Long) 

Subtract Normalized 

1 

ADR 

1 


| 2B 

1 

1 

SDR 

1 


| 2C 

1 

Multiply (Long) 

1 

MDR 

1 


| 2D 

1 

Divide (Long) 

1 

DDR 

1 


j 2E 

1 

Add Unnormalized (Long) 

1 

AWR 

1 


j 2F 

1 

Subtract Unnormalized (Long) 

1 

SWR 

1 


| 30 

1 

Load Positive (Short) 

1 

LPLR 

1 


1 31 

1 

Load Negative (Short) 

1 

LNER 

1 


1 32 

1 

Load and Test (Short) 

1 

LTER 

1 


| 33 

i 

1 

_L 

Load Complement (Short) 


LCER 

1 

_ j_ 


Figure 16. 
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RR Format 


h- ~t - 

| Operation | 

| Code j 

i ± 

Name 

- r -. 

1 

I 

4 

Mnemonic 

1 

| Remarks 

i 

r~ 

T 


■ -f - 


—t- 

34 

1 

Halve (Short) 

I 

HER 

1 

35 

1 

Load Rounded (Long to Short) 

I 

LRER 

| 85,195, 


1 


1 


j System/370 

36 

1 

Add Normalized (Extended) 

1 

AXR 

1 85,195, 


1 


I 


j System/370 

37 

1 

Subtract Normalized (Extended) 

I 

SXR 

I 85,195, 


1 


I 


j System/370 

38 

1 

Load (Short) 

I 

LER 

1 

39 

I 

Compare (Short) 

1 

CER 

1 

3A 

1 

Add Normalized (Short) 

1 

AER 

1 

3B 

! 

Subtract Normalized (Short) 

1 

SER 

1 

3C 

1 

Multiply (Short) 

1 

MER 

1 

3D 

1 

Divide (Short) 

1 

DER 

1 

3E 

1 

Add Unnormalized (Short) 

I 

AUR 

1 

3F 

1 

Subtract Unnormalized (Short) 

1 

SUR 

1 

1 

i 


4 



r~ 

T 


— - 1 


1 ■ 

1 RX Format 1 


1 


1 

1 

t _ 


4 


4 

r~ 

T 




t 

40 

1 

Store Halfword 

1 

STH 

1 

41 

1 

Load Address 

1 

LA 

I 

42 

1 

Store Charater 

1 

STC 

1 

43 

1 

Insert Character 

1 

IC 

1 

44 

I 

Execute 

1 

EX 

1 

45 

1 

Branch and Link 

1 

BAL 

1 

46 

1 

Branch on Count 

1 

BCT 

1 

47 

| 

Branch on Condition 

1 

BC 

1 

48 

1 

Load Halfword 

1 

LH 

1 

49 

1 

Compare Halfword 

1 

CH 

1 

4A 

I 

Add Halfword 

1 

AH 

1 

4B 

I 

Subtract Halfword 

1 

SH 


4C 

1 

Multiply Halfword 

i 

MH 

1 

4D 

1 


1 


1 

4E 

I 

Convert to Decimal 

1 

CVD 

1 

4F 

1 

Convert to Binary 

1 

CVB 


50 

1 

Store 

1 

ST 

i 

51 

1 


I 


1 

52 

1 


1 


1 

53 

1 


1 


I 

54 

1 

AND 

1 

N 

1 

55 

1 

Compare Logical 

1 

CL 

1 

56 

1 

OR 

1 

0 

1 

57 

1 

Exclusive OR 

1 

X 

I 

58 

1 

Load 

1 

L 

1 

59 

1 

Compare 

1 

C 

1 

5A 

1 

Add 

1 

A 

1 

5B 

1 

Subtract 

I 

S 

1 

5C 

1 

Multiply 

1 

M 

1 

5D 

1 

Divide 

1 

D 

1 

5E 

1 

Add Logical 

I 

AL 

1 

5F 

1 

1 

Subtract Logical 

1 

1 

SL 

1 

1 

60 

1 

1 

Store (Long) 

1 

1 

STD 

1 

1 

61 

j 


| 


1 

6^ 

1 


1 


1 

63 

I 


1 


1 

64 

i 


1 


1 

65 

I 


1 


I 

__ 

_ X-. 

. 





Figure 16. List of Machine Instructions by Operation Code (Part 2 of 5) 
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RX Format 



iB 


-T~* 

— 

r — ■ 

- -1 


II 


I 


I 



n 

Name 

1 

Mnemonic 

1 

Remarks | 




.. . .1 


± 

J 


r 


T 


—r— 


66 

1 


1 


1 


67 

1 

Multiply (Long to Extended) 

1 

MXD 

1 

85,195, j 


1 


1 


! 

System/370 j 

68 

1 

Load (Long) 

1 

ld 

1 


u y 

1 

C Oulpa 16 (liOHy) 

i 

CD 

i 

j 

6A 

1 

Add Normalized (Long) 

1 

AD 

1 


6B 

1 

Subtract Normalized (Long) 

I 

SD 

I 


6C 

1 

Multiply (Long) 

1 

MD 

1 


6D 

1 

Divide (Long) 

1 

DD 

1 


6E 

1 

Add Unnormalized (Long) 

1 

AW 

1 


6F 

1 

i 

Subtract Unnormalized (Long) 

1 

i 

SW 

1 

i 


70 

1 

1 

Store (Short) 

1 

1 

STE 

1 

l 


71 

1 


1 


1 


72 

1 


1 


l 


73 

1 


1 


I 


74 

1 


1 


l 


75 

1 


1 


1 


76 

1 


1 


l 


77 

1 


I 


I 


78 

1 

Load (Short) 

! 

le 

l 


79 

I 

C ompa re (Short) 

1 

CE 

l 


7A 

1 

Add Normalized (Short) 

I 

AE 

l 


7B 

1 

Subtract Normalized (Short) 


SE 

l 


7C 

1 

Multiply (Short) 

1 

ME 

I 


7D 

1 

Divide (Short) 

1 

DE 

l 


7E 

1 

Add Unnormalized (Short) 

1 

AU 

l 


7F 

1 

Subtract Unnormalized (Short) 

1 

SU 

l 



.4._ 


4 


_ 4_ 

■ 


T 


1 


T — 

1 

RS,SI Format! 


1 


1 



„i._ 


4 


_L . 

i 


T 


1 


-1 

1 

80 

1 

Set System Mask 

1 

SSM 

( 


81 

1 


1 


1 


82 

1 

Load PSW 

1 

LPSW 

1 


83 

1 

Diagnose 

1 


1 


84 

1 

Write Direct 

1 

WRD 

1 


85 

1 

Read Direct 

1 

RDD 

1 


86 


Branch on Index High 

1 

BXH 

1 


87 

1 

Branch on Index Low or Equal 

1 

BXLE 

1 


88 

1 

Shift Right Single Logical 

1 

SRL 

1 


89 

1 

Shift Left Single Logical 

1 

SLL 

1 


8A 

1 

Shift Right Single 

1 

SRA 

1 


8B 

1 

Shift Left Single 

1 

SLA 

I 


8C 

1 

Shift Right Double Logical 

1 

SRDL 

1 


8D 

1 

Shift Left Double Logical 

1 

SLDL 

1 


8E 

1 

Shift Right Double 

1 

SRDA 

1 


8F 

1 

Shift Left Double 

1 

1 

SLDA 

1 

1 


90 

1 

1 

Store Multiple 

1 

1 

STM 

1 

! 


91 

1 

Test under Mask 

1 

TM 

I 


92 

1 

Move (Immediate) 

1 

MVI 

1 


93 

1 

Test and Set 

1 

TS 

1 


94 

1 

AND (Immediate) 

1 

NI 

1 


95 

1 

Compare Logical (Immediate) 

1 

CLI 

1 


95 

1 

OR (Immediate) 

1 

01 

1 


97 

1 

Exclusive OR (Immediate) 

1 

XI 

I 


98 

1 

Load Multiple 

1 

LM 

1 


99 

I 


1 


1 


9A 

1 


1 


1 


9B 

I 


1 


1 



-A— 

-i Mr i.nr ■! i , _ . . 

__ 1 _ 


_ i _ 



Figure 16. List of Machine Instructions by Operation Code (Part 3 of 5) 
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j RS, SI Format 

j.-r 

| Operation | 
Code 


Mnemonic 


Remarks 


Start I/O, Start I/O Fast Release 
Test I/O 

Halt I/O, Halt Device 
Test Channel 


SIG,SIOF 

TIC 

HIC,HEV 
TCH 


See Note 2 


See Note 1 


Monitor Call 


(First byte of two-byte operation codes) 


Store Control 


STCTL 


Load Control 


System/370 
only 


See Note 3 


System/370 
only 

System/370 
only 


Compare Logical Characters 
under Mask 

Store Characters under Mask 
Insert Characters under Mask 


System/370 
only 

System/370 

only 

System/370 
only 


Format 


Figure 16. List of Machine Instructions by Operation Code (Fart 4 of 5) 
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j SS Format 

y - 

j Operation 
| Code 

| - 

j CD 
| CE 
j CF 
I DO 


Mnemonic 


Remarks 


move numerics 
Move (Characters) 

Move Zones 
AND (Characters) 

Compare Logical (Characters) 
OR (Characters) 

Exclusive OR (Characters) 


Translate 

Translate and Test 
Edit 

Edit and Mark 


Shift and Round Decimal 

Move with Offset 

Pack 

Unpack 


Zero and Add Decimal 
Compare Decimal 
Add Decimal 
Subtract Decimal 
Multiply Decimal 
Divide Decimal 


System/370 

only 


Figure 16. List of Machine Instructions by Operation Code (Part 5 of 5) 


Note 1 ; On the Model 195 and Systen/370 machines, the machine operations for 
Halt Device and Halt I/O are as follows: 
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Halt I/O HIO 


--- 

: 1001 1110 xxxx xxxo | 

l_ J 

r-1 

i 1001 1110 XXXX XXXI I Halt Device HDV 

i_J 


(X denotes an ignored bit position) 

On other System/360 machines the Halt I/O operation code is: 

r-▼—i 

j 1001 1110 XXXX XXXX j 

l-J 

The Halt Device instruction does not exist under this system; the second byte is 
completely ignored. 

Note 2 : Under the System/370 architecture the machine operations for Start I/O and 
Start I/O Fast Release are as follows: 


1001 

1100 

xxxx 

xxxo 

1 

1 

Start 

I/O 

SIO 

1001 

1100 

xxxx 

XXXI 

“1 

1 

-J 

Start 

I/O 

Fast Release SIOF 


(X denotes an ignored bit position) 
Under System/360 the Start I/O code is: 


r-1 

j 1001 1100 XXXX XXXX j 

L_J 

The Start I/O Fast Release instruction does not exist under this system. The second 
byte is completely ignored. 

Note 3: The following operation codes occupy two bytes of Si-type instructions. They 
can be used on System/370 machines only. 


r- 1 -f- 1 

| Operation | J J 


Code 

1 

_j_ . 

Name 

j Mnemonic 

i ...... 

B202 

t 

1 

Store CPU ID 

— - t ^ ~~ - - 

j STIDP 

B203 

1 

Store Channel ID 

j STIDC 

B204 

1 

Set Clock 

| SCK 

B205 

1 

Store Clock 

| STCK 


—r_. 


f 


The special Model 85, Model 195, and Systen/370 instructions are supported only by the 
DOS Assembler D, 14K variant. 
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Operand Format 


Explicit 

Implicit 

R1,D2(X2,B2) or R1,D2(,B2) 
R1,R2 

j Rl ,S2 (X2) or R1 ,S2 

1 

D 1 (LI, B 1) ,D2 (L2, B2) 

jsi (LI) ,S2(L2) or 
| SI,S2 

R1, D2 (X2, B2) or Rl,D2(,B2) 

j Rl ,S2 (X2) or Rl ,S2 

R1.D2 (X2,B2) or R1 f D2(,B2) 

| FI ,S2 (X2) or Rl ,S2 

1 

R1,R2 

1 

1 

1 

R 1, R2 

R1,D2 (X2, B2) or R1,D2(,B2) 

I 

1 

| Rl ,S2 (X2) or Rl ,S2 

R1.R2 

1 

R1,D2 (X2,B2) or R1,D2( r B2) 
R1,R2 

j Rl ,S2 (X2) or Rl ,S2 

1 

R1,D2 (X2,B2) or R1,D2(,B2) 
R1,R2 

1 

j Rl ,S2 (X2) or Rl ,S2 

1 

I 

R1,D2 (X2,B2) or R1,D2(,B2) 

1 

j Rl ,S2 (X2) or Rl ,S2 

i 

R1,R2 

R1,D2 (X2,B2) or R1,D2(,B2) 

1 

1 

j Rl ,S2 (X2) or R1,S2 

i 

D1 (L, B1) r D2 (B2) 

R1,R2 

1 

|S1 (L) ,S2 or SI ,S2 

1 

D 1 (B1) ,12 

|S1,12 

R1,D2 (X2,B2) or R1,D2(,B2) 
R1,R2 

| Rl ,S2 (X2) or Rl ,S2 

1 

M1,D2(X2,B2) or M1,D2(,B2) 

1 

j Ml ,S2 , (X2) or 
|M1,S2 

M1,R2 

R1,D2 <X2,B2) or R1,D2(,B2) 

R1, R2 

1 

j Rl ,S2 (X2) or Rl ,S2 

1 

D2 (X2,B2) or D2 (,B2) 

| S2 (X2) or S2 

1 

D2 (X2,B2) or D2 (,B2) 

| S2 (X2) or S2 

R1,R3,D2 (B2) 

|R1 f R3,S2 

i 

R1,R3,D2 (B2) 

i 

j Rl,R3,S2 

D2(X2,B2)or D2 (,B2) 

j S2 (X2) or S2 

D2 (X2,B2) or D2 (,B2) 

j S2 (X2) or S2 

■ 

D2 (X2,B2) or D2 (,B2) 

1 

J S2 (X2) or S2 

D2 (X2,B2) or D2 (,B2) 

j S2 (X2) or S2 

D2 (X2,B2) or D2 (,B2) 

| S2 (X2) or S2 

D2 (X2,B2) or D2 (,B2) 

|S2(X2) or S2 

D2(X2,B2)or D2 (,B2) 

1S2 (X2) or S2 


x. 


1 Of 14) 












jInstruction 

i 

j Mnemonic j Machine 
j Operation!Operation 
|Code j Code 

.j. j. 

1 Operand Format 

I 

| Explicit Implicit 

r 

| Branch on Not Ones 

| BNO 

| 47 (BC 

14) 

| D2 (X2,B2) or D2 (,B2) 

| S2 (X2) or S2 

jBranch on Not Plus 

| BNP 

j 47 (BC 

13) 

|D2 (X2,B2) or D2 (,B2) 

|S2(X2) or S2 

jBranch on Not Zeros 

| BNZ 

j 47 (BC 

7) 

|D2 (X2,B2) or D2 (,B2) 

j S2 (X2) or S2 

jBranch if Ones 

| BO 

j 47 (BC 

1) 

|D2 (X2,B2) or D2 (,B2) 

j S2 (X2) or S2 

jBranch on Overflow 

j BO 

1 

J 47 (BC 

1 

1) 

|D2 (X2,B2) or D2 (,B2) 

1 

j S2 (X2) or S2 

1 

jBranch on Plus 

1 

|BP 

1 

j 47 (BC 

2) 

1 

j D2 (X2,B2) or D2 (,B2) 

1 

j S2 (X2) or S2 

jBranch if Zeros 

j BZ 

| 47 (BC 

8) 

|D2 (X2,B2) or D2 (,B2) 

|S2(X2) or S2 

j Branch on Zero 

|BZ 

| 47 (BC 

8) 

|D2 (X2,B2) or D2 (,B2) 

j S2 (X2) or S2 

jBranch Unconditional 

j B 

j 47 (BC 

15) 

|D2 (X2,B2) or D2 (,B2) 

J S2 (X2) or S2 

jBranch Unconditional 

j BR 

i 

| 07 (BCR 

1 

15) 

|R2 

1 

1 

I 

jCompare Algebraic 

1 

jc 

I 

1 59 


1 

|R1,D2 (X2,B2) or R1,D2(,B2) 

1 

jR1 ,S2 (X2) or R1 ,S2 

jCompare Algebraic 

J CR 

1 19 


J R1,R2 

1 

jCompare Decimal 

jcp 

j F9 


j D1 (L1,B1) ,D2 (L2,B2) 

J SI (LI) ,S2 (L2) or 

1 Compare Halfword 

1 

jCH 

1 

| 49 


1 

|R1,D2 (X2.,B2) or R1,D2(,B2) 

|S1,S2 

j R1 ,S2 (X2) or R1 ,S2 

jCompare Logical 

| CL 
j 

1 55 
j 


j R1, D2 (X2, B2) or R1,D2(,B2) 

1 

jR1 ,S2 (X2) or R1 ,S2 

i 

jCompare Logical 

| CLC 
| 

|D5 

l 


1 

j D1 (L,B1) ,D2 (B2) 

| 

1 

I SI (L) ,S2 or SI ,S2 

i 

jCompare Logical 

| CLR 

1 

1 15 


j R1,R2 

1 

i 


jCompare Logical 
jCharacters under 
|Mask 

jCompare Logical 
jImmediate 

jCompare Logical Long 
jCompare,Long 
jCompare,Long 

jCompare,Short 
jCompare,Short 
jConvert to Binary 
Convert to Decimal 


Rl,M3,D2, (B2) 

D1 (B1) ,12 
R1,R2 

R1,D2 (X2,B2) or R1,D2(,B2) 
Rl,R2 

R1,D2 (X2,B2) or R1,D2(,B2) 
R1,R2 

R1,D2 (X2,B2) or Rl,D2(,B2) 
R1,D2 (X2,B2) or R1,D2(,B2) 


R1,M3,S2 
SI,12 

R1,S2(X2) or R1 ,S2 

R1 ,S2 (X2) or R1 .S2 

R1,S2(X2) or R1 ,S2 
R1,S2(X2) or R1,S2 


Figure 17. Machine Instruction Summary (Part 2 of 14) 
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| J Program Interruptions 

j (Possible 

Condition Code Set 


i v ' J - ITT T T T 

(Instruction JA|SJOvJPJOpJOther 

.X _____ j_X—X X—X_L—_—_ 

i oo 

_L 

i oi 

i . 

i io 

i 

T 

1 11 

1 


-- 1 — t t + T—T- 

T- ' 

T 

T 

T - 

|Add 

| RX (x( 

x|F | 

1 

( Sum=0 

|Sum<0 

|Sum>0 

(Overflow 

|Add 

| RR f j 

(F | 

1 

j Sum=0 

|Sum<0 

JSum>0 

j Overflow 

|Add Decimal 

jss, Decimal jxj 

j D jx 

x j Data 

jSum=0 

j Sum<0 

|Sum>0 

j Overflow 

(Add Halfword 

j RX | xj 

x|F j 

I 

Sum=0 

1 SurtKQ* 

SumCO 

Overflow 

|Add Logical 

(RX (x| 

1 1 1 

xj j 

1 1 

1 

1 

j Sum=^0(S>| Sum 0(gj Sum=^0®| Sum 0 (J) 

! I 1 1 

|Add Logical 

| RR || 

1 1 

1 1 

1 

1 

1 J J J _ 

j Sum=0(g) Sum=0®j Sum=Q(J)| Sum 0 (J) 

JAdd Normalized, 

1 1 1 

1 1 

1 

1 

1 

1 

1 

j Extended 

|RR,Floating Pt. j j 

x|E | 

x | B,C 

|R 

L 

JM 

1 

|Add Normalized,Long 

|RX,Floating Pt.jxj 

xj E j 

x |B,C 

j R 

L 

|M 

P 

lAdd Normalized,Lonq 

|RR,Floatinq Pt.1 1 

x(E | 

x 1 B,C 

IR 

IL 

IM 

IP 

|Add Normalized,Short 

|RX,Floating Pt.jxj 

xj E j 

x j B,C 

(r 

| L 

M 

P 

|Add Normalized,Short 

|RR,Floating Pt.j | 

1 1 1 

xj E j 
a i 

x | B, C 

| 

jR 

1 

j L 

1 

|M 

|P 

JAdd Unnormalized, 

1 1 1 

1 1 1 

i ( 
i i 

1 

1 

1 

1 

1 

1 

1 

1 

1 

JLong 

(RX,Floating Pt.jxj 

xj E j 

x |C 

jR 

|L 

jM 

|P 

|Add Unnormalized, 

1 1 1 

1 1 

1 

1 

1 

1 

1 

JLong 

jRR,Floating Pt. j j 

x j E j 

x jc 

jR 

|L 

jM 

jP 

JAdd Unnormalized, 

1 1 1 

1 1 

1 

1 

1 

1 

1 

j Short 

(RX,Floating Pt.|x| 

x j E j 

x (C 

jR 

j L 

jM 

jP 

|Add Unnormalized, 

I 1 1 

! 1 

1 

I 

1 

1 

1 

| Short 

|RR,Floating Pt. | ( 

xj E j 

x jC 

R 

L 

jM 

jP 

JAdd Logical 

j RX (xj 

l l l 

xj j 

1 1 

1 

i 

j J 
■ 

(K 

1 

1 

i 

1 

1 

|And Logical 

1 1 1 

(SS jxj 

1 1 

1 1 x 

1 

1 

1 

j J 

1 

j K 

1 

1 

1 

1 

JAnd Logical 

| RR jj 

1 1 

1 

jj 

j K 

1 

1 

JAnd Logical Immediate 

jsi jx| 

1 l x 

1 

j J 

j K 

1 

1 

| Branch and Link 

j RX If 

1 1 

1 

N 

N 

N 

N 

(Branch and Link 

| RR || 

i i i 

1 1 

1 1 

1 

|N 

i 

j N 

1 

jN 

1 

j N 

j Branch on Condition 

i ( i 

RX 

1 1 

1 1 

1 

1 

i 

IN 

1 

N 

1 

N 

1 

N 

j Branch on Condition 

rr 1 

1 1 

1 

N 

N 

| N 

N 

j Branch on Count 

RX 

1 1 

1 

j N 

N 

N 

N 

(Branch on Count 

j RR (j 

1 1 

1 

N 

N 

N 

N 

jBranch on Equal 

j RX,Ext.Mnemonic! j 

i i i 

1 1 

1 1 

1 

1 

|N 

1 

j N 

1 

j N 
■ 

| N 

I 

(Branch on High 

1 1 1 
|RX,Ext.Mnemonic| | 

1 1 

I 1 

1 

1 

I 

N 

1 

N 

i 

N 

i 

N 

(Branch on Index High 

j RS ( ( 

1 1 

1 

|N 

j N 

j N 

jN 

|Branch on Index Low 

1 1 1 

1 1 

1 

1 

1 

1 

1 

(or Equal 

j RS j j 

1 i 

1 

|N 

N 

N 

N 

(Branch on Low 

jRX,Ext.Mnemonicj j 

1 1 

1 

N 

N 

N 

N 

jBranch if Mixed 
| 

jRX,Ext.Mnemonic! j 

i i i 

1 1 

1 1 

1 

fl 

|N 

1 

j N 

I 

|N 

1 

|N 

| 

1 

| Branch on Minus 

i 1 1 

| RX , Ext • Mnemonic | | 

1 1 

1 I 

1 

1 

I 

N 

1 

N 

! 

N 

In 

jBranch on Not Equal 

jRX,Ext.Mnemonic! 1 

1 1 

1 

jN 

j N 

jN 

n 

jBranch on Not High 

jRX,Ext.Mnemonic! j 

1 1 

1 

(N 

N 

N 

N 

jBranch on Not Low 

j RX,Ext.Mnemonic j j 

1 1 

1 

j N 

N 

|N 

N 

| Branch on Not Minus 

|RX,Ext.Mnemonic! j 

1 1 

1 

| N 

j N 

|N 

j N 


.JL-JL-X-X_X-X. 
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r —-- 

|Instruction 

T -- 

1 

1 

| Type of 
jInstruction 
j. 

• ~ T 

(Program Interruptions 

j Possible 

1 

Condition Code Set 

— 1 

1 

r T T T T T T T 

jA|S|0v|P|0p|0ther j 00 j 01 

J. J. X X X X X _ L 

j 10 

— x_ 

T 

1 11 
-X _ _ 

1 

J 



I 1 l 

i r t 

l 

< 

1 

T 

1 

jBranch on Not Ones 

(RX,Ext.Mnemonic | | | 

I 1 1 

JN 

jN 

j N 

jN 


j Branch on Not Plus 

(RX,Ext.Mnemonicj j j 

1 1 1 

|n 

}n 

|N 

|N 


| Branch on Not Zeros 

| RX,Ext.Mnemonic ( j j 

1 1 1 

|N 

(N 

i N 

i N 


| Branch if Ones 

jRX,Ext.Mnemonic! | j 

1 1 1 

i N 

i N 

i N 

i N 


j Branch on Overflow 

JRX,Ext.Mnemonic! j j 

i III 

1 1 1 

1 1 1 

In 

1 

|N 

1 

jN 

1 

i N 

i 


jBranch on Plus 

1 III 

| RX, Ext. Mnemonic ( | ( 

I 1 1 

J 1 1 

1 

| N 

1 

| N 

1 

j N 

i 

| N 


jBranch if Zeros 

jRX,Ext.Mnemonicj | j 

1 1 1 

j N 

jN 

i N 

jN 


JBranch on Zero 

jRX,Ext.Mnemonicj | j 

1 1 1 

j N 

|N 

jN 

i N 


j Branch Unconditional 

jRX,Ext.Mnemonicj j J 

1 1 1 

i N 

i n 

i N 

i N 


jBranch Unconditional 

jRR,Ext.Mnemonic! j | 

i iii 

1 1 1 

1 1 1 

i N 

1 

j N 

1 

jN 

i 

i N 

i 


jCompare Algebraic 

i 

(RX 

1 1 1 

1 x l x l 

1 1 1 

1 1 1 

I 

j Z 

1 

| AA 

1 

JBB 

i 


(Compare Algebraic 

j RR 

1 1 1 

1 1 1 

i z 

j AA 

j BB 

i 


jCompare Decimal 

j SS,Decimal 

I x| I 

1 J x |Data | Z 

j AA 

j BB 

i 


(Compare Halfword 

(RX 

j X j X I 

1 1 1 

I Z 

j AA 

| BB 

i 


(Compare Logical 

j RX 

j 

j xj xj 
t ! I 

1 1 1 

1 I ! 

j z 

1 

jAA 

j 

j BB 

j 

i 

i 


(Compare Logical 

| SS 

1 1 J 

1 X l X l 

1 1 1 

1 1 1 

I Z 

(AA 

(BB 

i 


(Compare Logical 

j RR 

|x| 1 

1 1 1 

j z 

jAA 

j BB 

i 


(Compare Logical 

1 

1 1 1 

1 1 1 

I 

1 

1 

i 


(Characters under 

1 

1 1 1 

1 1 1 

1 

1 

1 

i 


(Mask 

j RS 

1 x ! 1 

(xjx ( 

(XX 

j YY 

i zz 

i 


(Compare Logical 

1 

1 1 1 

1 I 1 

1 

1 

1 

i 


j Immediate 

1 si 

1 x l 1 

1 1 1 

j z 

(AA 

j BB 

i 


j Compare Logical Long 

| RR 

i x i x 

x| X 1 

i z 

jAA 

BB 

i 


jCompare,Long 

j RX,Floating 

pt. i x j x i 

1 1 x I 

i z 

jAA 

JBB 

i 


J Comapre,Long 

j RR,Floating 

1 

Pt.|x|xj 
i i i 

1 j x j 
! 1 1 

j z 

1 

jAA 

j 

Jbb 

j 

i 

i 


(Compare,Short 

1 

| RX,Floating 

i i I 
Pt. | x|x| 

1 1 1 

1 1 x 1 

1 

I Z 

( AA 

(BB 

l 

i 


(Compare,Short 

j RR,Floating 

Pt. j jxj 

1 jxj 

j z 

jAA 

j BB 

i 


(Convert to Binary 

1 RX 

i x i x i 

( I J Data,F J N 

i N 

jN 

jN 


(Convert to Decimal 

j RX 

I x( x| 

1 x 1 1 

|N 

i N 

|N 

j N 



_X _ -- 

_J_x_x 

X X- X 

_ X __ 

_!_ 

_I_ 

_x_ 

_J 
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r -- - 

|Instruction 

L 

—T-- 

|Mnemonic 
j Operation 
J Code 

. L __ 

i-- 

J Machine 
j Operation 
j Code 

i . 

| Operand Format 

1 

| Explicit Implicit 

j. ^ 

-- 1 

r 

r 

r 

T 

T 


1 

| Divide 

1 D 

j 5D 

|R1,D2 (X2,B2) or 

R1 ,D2 (,B2) |R1 ,S2 (X2) 

or 

R1 ,S2| 

(Divide 

(DR 

1 ID 

R1,R2 

1 



jDivide Decimal 

j DP 

j FD 

| D1, (L1,B1) ,D2 (L2,B2) |S1 (LI) ,S2 (L2) 

or | 


1 

1 

1 

|S1,S2 



| Divide,Long 

|DD 

| 6D 

J R 1, D2 (X2,B2) , or 

R1,D2 (,B2) |R1 ,S2 (X2) 

or 

R1 ,S21 

(Divide,Long 

1 DDR 

i 

1 2D 

i 

IR1.R2 

i 

1 

i 


1 

1 

j Divide,Short 

i 

|DE 

1 

( 7D 

1 

| R1, D2 (X2,B2) or 

i 

R1 ,D2 (,B2) | R1 ,S2 (X2) 

or 

R1 ,S21 

j Divide,Short 

(DER 

j 3D 

J R 1,R2 

1 



j Edit 

| ED 

|DE 

j D 1 (L, B1) ,D2 (B2) 

(SI (L) ,S2 

or S1,S2 | 

|Edit and Mark 

EDMK 

DF 

j D1 (L,B1) ,D2 (B2) 

(SI (L) ,S2 

or Si,S2 j 

j Exclusive Or 

I Y 

i — 

1 

1 S7 

i ~ 

1 

1R1, D2 (X2, B2) or 

i 

Pi n? / .R9t IP1 Q9 /Y91 

— \r-/ | -- • --x- ) 

1 

or 

TJ1 CJI 

(Exclusive Or 

i 

JXC 

i 

| D7 

1 

j D 1 (L,B1) ,D2 (B2) 

(SI (L) ,S2 

or Si,S2 | 

(Exclusive Or 

JXR 

1 17 

j R 1,R2 

t 



(Exclusive Or 

1 

1 

1 

1 



jImmediate 

jxi 

| 97 

j D1 (B1) , 12 

1 SI,12 



j Execute 

| EX 

j 44 

|R1,D2 (X2,B2) or 

R1 ,D2 (,B2) j R1 ,S2 (X2) 

or 

R1 ,S2| 

jHalve,Long 

| HDR 

1 

[24 

1 

j R 1,R2 

2 

1 

i 



| Halve,Short 

I 

(HER 

1 

| 34 

J R1,R2 

1 

1 



(Halt Device 

(HDV 

J 9E 1 

1 D1 (B1) 

jsi 



(Halt I/O 

( HIO 

9E 1 

| D1 (B1) 

i si 



(Insert Character 

|IC 

1 43 

J R 1, D2 (X2, B2) or 

R1,D2 (,B2) | R1 ,S2 (X2) 

or 

R1 ,S21 

(Insert Characters 

1 

1 

i 

1 



(under Mask 

| ICM 

|BF 

JR1,M3,D2 (B2) 

|R1,M3,S2 



(Insert Storage Key 

| ISK 

| 09 

j R1,R2 

1 



|Load 

j L 

1 58 

1 

j R1 # D2 (X2,B2) or 

a 

R1,D2 (,B2) J R1 ,S2 (X2) 

i 

or 

R1,S2| 

|Load 

1 

j LR 

1 

| 18 

|R 1,R2 

1 

1 



|Load Address 

| LA 

1 41 

|R1,D2 (X2,B2) or 

R1 ,D2 (,B2) j R1 ,S2 (X2) 

or 

R1 ,S2| 

(Load and Test 

j LTR 

1 12 

|R1,R2 

1 . 



(Load and Test,Long 

|LTbR 

| 22 

j R1,R2 

1 



(Load and Test,Short 

| LTER 

| 32 

j R1,R2 

1 

1 



|Load Complement 

l 

| LCR 

1 

1 I 3 

1 

JR1,R2 

1 

1 



|Load Complement,Long 

j LCDR 

1 23 

j R 1,R2 

I 



(Load Complement,ShortJLCER 

1 33 

j R1,R2 

1 



|Load Control 

| LCTL 

|B7 

(R1,R3,D2 (B2) 

J R1,R3,S2 



|Load Halfword 

j LH 

j 48 

JR1,D2 (X2,B2) or 

R1,D2 (,B2) | R1 ,S2 (X2) 

or 

R1 ,S2| 

(Load,Long 

| LD 

| 68 

JR1,D2 (X2,B2) or 

R1,D2 (,B2) j R1 ,S2 (X2) 

or 

R1 ,S2| 

jLoad,Long 

j LDR 

( 28 

j R 1 ,R2 

1 



|Load Multiple 

j LM 

| 98 

JR1,R3,D2 (B2) 

|R1,R3,S2 



(Load Negative 

(LNR 

I 11 

JR1,R2 

1 



|Load Negative,Long 

(LNDR 

1 21 

J R1, R2 

1 



(Load Negative,Short 

|LNER 

1 

1 31 

1 

J R 1 ,R2 
} 

1 

1 



(Load Positive 

J.LPR 

1 1° 

| R 1, R2 

1 

1 



|Load Positive,Long 

|LPDR 

| 20 

|R1,R2 




|Load Positive,Short 

| LPER 

| 30 

J R1 ,R2 

1 



|Load PSW 

j LPSW 

] 82 

|D1,(B1) 

| SI 



|Load Rounded, 

1 

1 

1 

1 



(Extended to Long 

| LRDR 

1 25 

| R 1,R2 




|Load Rounded, 

1 

1 

1 

1 



|Long to Short 

j LRER 

1 35 

|R1,R2 

1 



jLoad,Short 

|LE 

I 7 8 

|R1,D2 (X2,B2) or 

R1 ,D2 (,B2) j R1 ,S2 (X2) 

or 

R1 ,S21 

V- 

_r- 

i._ 

i- 

_J_* 

— 



I 1 See Note 1, Figure 16. | 

i---1 


Figure 17. Machine Instruction Summary (Part 5 of 14) 


134 









r 

| Instruction 

I-- 

| Load,Short 

|Mnemonic |Machine | Operand Format | 

j Operation!Operation j j 

jcode (Code j Explicit Implicit J 

_ J. _L J. 1 

| LER 

| 38 

| R1, R2 

T -“1 

1 | 

jMonitor Call 

j MC 

j AF 

j D1 (B1) ,12 

JS1,I2 | 

|Move Characters 

J MVC 

|D2 

jD1 (L,B1) ,D2 (B2) 

j SI (L) ,S2 or S1,S2 j 

|Move Immediate 

j MVI 

| 92 

j D1 (B1) ,12 

|S1,12 | 

jMove Long 

| MVCL 

j OE 

|R1,R2 

! ! 

|Move Numerics 

| MVN 

| C1 

|D1 (L,B1) ,D2 (B2) 

| S1 (L) ,S2 or S1,S2 | 

|Move with Offset 

j MVO 

|F1 

jD1 (L1,B1) ,D2 (L2,B2) 

jS1 (LI) ,S2 (L2)or | 


1 

1 

1 

1 

I 

1 

|SI ,S2 | 

1 1 

|Move Zones 

1 

| MVZ 

1 

j D3 

1 

|D1 (L,B1) ,D2 (B2) 

1 1 
jsi (L) ,S2 or S1,S2 j 

jMultiply 

j M 

1 5C 

|R1,D2 (X2,B2) or R1,D2(,E2) 

j R1 ,S2 (X2) or R1,S2| 

jMultiply 

j MR 

1 ic 

|R1,R2 

I 1 

jMultiply Decimal 

| MP 

j FC 

jD1 (L1,B1) ,D2 (L2,B2) 

jsi (LI) ,S2 (L2) or j 


1 

I 

1 

jsi,S2 j 

jMultiply, Extended 

j MXR 

| 26 

|R1,R2 


jMultiply Halfword 

j MH 
j 

| 4C 
j 

|R1,D2 (X2,B2) or R1,D2(,E2) 

|R1,S2(X2) or R1,S2| 

i t 

| Multiply,Long 

|MD 

| 6C 

|R1,D2 (X2,B2) or R1,D2(,E2) 

i i 

jR1 ,S2 (X2) or Rl,S2j 

jMultiply,Long 

| MDR 

j 2C 

|R1,R2 

1 1 

jMultiply, Long to 

1 

1 


1 1 

j Extended 

J MXD 

| 27 

|R1,D2 (X2,B2) or R1,D2(,E2) 

jRl,S2 (X2) or R1 (S2) 

jMultiply, Long to 

1 

1 

1 


j Extended 

J MXDR 

1 67 

|R1,R2 

! 1 

| Multiply,Short 

|ME 

J 7C 

|R1,D2 (X2,B2) or R1,D2(,E2) 

j Rl ,S2 (X2) or Rl ,S2 j 

j Multiply,Short 

JMER 

1 3C 

j R1, R2 


|No Operation 

j NOP 

j 47 (BC 0) 

|D2(X2,B2) 'r D2(,B2) 

|S2(X2) or S2 | 

Figure 17. Machine 
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-J_ _ 
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r - - -IT--- — 

1 1 

1 1 

(Instruction 1 Type of 

j jInstruction 

L 

- T— -- - - 

(Program Interruptions 
( Possible 

1— T— T T“T T - T - 

(AjsjOvjp(Opjother j 00 
j. j. j. j. j. j. j. 

Condition Code Set 

J 01 | 10 | 11 

x x j. 

-1 

-^ 

_j 

(Divide 

| RX 

T T T 
( X | X | 

r t 

1 

T 

1F 

T 

|N 

T 

IN 

T 

N 

| N 


(Divide 

J RR 

i x 

1 

|F 

|N 

N 

N 

N 


(Divide Decimal 

j SS,Decimal 

( X (x | 

X |x 

|D,Data|N 

N 

IN 

j N 


(Divide,Long 

j RX,Floating 

Pt.(x(x|E 

jx 

|B,E 

IN 

j N 

j N 

j N 


jDivide,Long 

j RR,Floating 

1 

Ft. ( jx j E 

1 1 1 

i* 

1 

| B,£, 

1 

1 n 

1 

fft 

1 

fft 

1 

pN 

1 


jDivide,Short 

1 

(RX,Floating 

1 1 1 

Pt.jxjxJE 

1 

|x 

1 

|b,e 

1 

jN 

1 

jN 

1 

j N 

1 

| N 


(Divide,Short 

j RR,Floating 

Pt.j jx(E 

jx 

|b,e 

j N 

jN 

jN 

l N 


(Edit 

j SS,Decimal 

jx j j 

X jx 

j Data 

S 

j t 

(u 

1 


(Edit and Mark 

(SS,Decimal 

jxj j 

X jx 

jData 

js 

j t 

ju 

1 


(Exclusive Or 

j~RX 

i 

jx jx j 

1 1 t 

“1 

1 

i 

1 

j J 
| 

jK 

1 

1 

1 

1 

I 


(Exclusive Or 

i 

J SS 

1 1 i 

I X 1 ] 

1 

X I 

1 

1 

j J 

i 

jB 

1 

1 

1 

1 


(Exclusive Or 

j RR 

1 1 1 

1 

1 

j J 

j K 

1 

1 


(Exclusive Or 

1 

i 1 1 

1 

1 

1 

1 

1 

1 


jImmediate 

1 si 

|x] 1 

x 1 

1 

| J 

jK 

1 

1 


( Execute 

j RX 

j X j X j 

! 

| G 

(May 

be set by 

this 

instruction! 

(Halve,Long 

j RR,Floating 

1 

pt.j jxj 

(X 

1 

1 

1 

| N 

1 

| N 

1 

j N 

I 

| N 

1 


jHalve , Short 

1 

| RR,Floating 

Pt.J |x( 

1 

Jx 

1 

| N 

| N 

| N 

( N 


(Halt Device 

SI 

1 1 i 

1 

A 

jDD 

JCC 

j AAL 

|KK 


(Halt I/O 

1 si 

1 1 ! 

1 

|A 

jDD 

|CC 

j GG 

jKK 


jInsert Character 

| RX 

1 X I { 

1 


j N 

j N 

j N 

j N 


jInsert Characters 

I 

1 1 1 

1 

1 

1 

1 

1 

1 


j under Mask 

j RS 

1 X j J 

X |x 

1 

juo 

|TT 

jss 

1 


jInsert Storage Key 

| RR 

j X j X j 

jx 

|A 

j N 

j N 

j N 

|N 


|Load 

j RX 

i 

jx jx j 

1 1 1 

1 

1 

1 

l 

J N 

1 

| N 

1 

j N 

l 

|N 

l 


j Load 

i 

| RR 

1 1 I 

1 1 1 

1 

1 

1 

1 

i 

| N 

i 

IN 

1 

N 

1 

| N 


|Load Address 

| RX 

1 1 1 

1 

1 

N 

N 

j N 

j N 


|Load and Test 

J RR 

1 1 1 

1 

1 

j J 

| L 

|M 

1 


(Load and Test,Long 

jRR,Floating 

Pt.J jxj 

|x 

1 

jR 

j L 

jM 

1 


(Load and Test,Short 

j RR,Floating 

Pt.j jxj 

1 1 1 

jx 

1 

1 

1 

j R 

1 

l L 

i 

jM 

1 

1 

1 


|Load Complement 

1 

(RR 

1 1 I 

1 j jF 

1 

I 

1 

1 

I 

(P 

1 

j L 

1 

|M 

1 

jo 


(Load Complement,Long 

(RR,Floating 

Pt.j |x| 

|x 

1 

| R 

j L 

|M 

1 


(Load Complement,Short 

j RR,Floating 

Pt.j jxj 

jx 

1 

IB 

|L 

jM 

1 


|Load Control 

(RS 

X jx 

X jx 

i a 

N 

N 

j N 

j N 


|Load Halfword 

| RX 

jx jx j 

1 

i 

j N 

jN 

jN 

jN 


(Load,Long 

|RX,Floating 

Pt.(X|X| 

|x 

i 

j N 

j N 

j N 

j N 


J Load,Long 

(RR,Floating 

Pt.j jxj 

jx 

i 

IN 

j N 

j N 

j N 


(Load Multiple 

(RS 

1 X 1 X j 

! 

i 

IN 

(N 

jN 

j N 


(Load Negative 

(RR 

i i i 

1 

i 

j J 

i L 

1 

1 


(Load Negative,Long 

(RR,Floating 

Pt.j jxj 

|x 

i 

j R 

|L 

1 

1 


|Load Negative , Short 

j RR,Floating 
l 

Pt.j jxj 

1 1 1 

jx 

I 

i 

i 

jB 

1 

i L 

• 

1 

i 

1 

| 


(Load Positive 

1 

| RR 

1 1 1 
j j jF 

1 

1 

i 

i 

1 

j J 

i 

i 

| M 

|0 


|Load Positive,Long 

j RR,Floating 

Pt.j |xj 

|x 

i 

j B 

jL 

jM 

1 


|Load Positive,Short 

j RR,Floating 

Pt.j jxj 

jx 

i 

JR 

i L 

jM 

1 


(Load PSW 

I si 

j X 1X 1 

1 

(A 

ICC 

ICC 

ICQ 

ICQ 


Load Rounded,Extended( 

1 ] 1 

1 

1 

1 

i 

1 

1 


j to Long 

|RR,Floating 

Pt.j jx j E 

|x 

1 

jN 

jN 

jN 

j N 


(Load Rounded,Long 

1 

1 1 ! 

1 

1 

1 

1 

1 

1 


j to Short 

|RR,Floating 

Pt.j jx j E 

|x 

1 

jN 

jN 

jN 

j N 


(Load,Short 

j RX,Floating 

Pt.jxjxj 

jx 

1 

| N 

| N 

| N 

j N 


(Monitor Call 

|SI 

jx 

x 

|G,A 

j N 

j N 

j N 

j N 



X - 

_J_L_L-J._L_ 

-X--- 


_ X __ 

X_ 

_X- 

_j 
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Instruction 


j Program Interruptions 

|Possible Condition Code set 

Type of 1 T T - T“T-T - T-T-T-T- 

Instruction jAJ SJOvjPjOpJ Other | 00 J 01 j 10 j 11 


| Load,Short 

_x_ 

J RR,Floating 

- 

Pt.j jxj 

i I X 

-+- 

1 

r— ~ 

JN 

—r~ 
jN 

T ” 
j N 

-+— 
jN 

|Move Characters 

| SS 

J X j j 

1 x| 

1 


JN 

jN 

jN 

JMove Immediate 

j SI 

j xj j 

jxj 

1 

JN 

IN 

jN 

jN 

| Move Long 

j RR 

i xj xj 

j X j X 

1 

j AAA 

jAAB 

JAAC 

j AAD 

JMove Numerics 

j SS 

1 xj j 

X 

1 

N 

N 

j N 

N 

JMove with Offset 

| SS 

1 

j xj 1 

I 1 1 

jxj 

1 1 

1 

1 

JN 

1 

JN 

I 

JN 

1 

j N 

1 

JMove Zones 

1 

j SS 

] 1 1 

1 xj 1 

1 1 

2 x | 

I 

1 

I 

jN 

1 

jN 

1 

jN 

1 

N 

jMultiply 

j RX 

j xj xj 

1 1 

1 

|N 

jN 

jN 

|N 

jMultiply 

J RR 

j jxj 

1 I 

1 

|n 

j N 

i N 

|N 

JMultiply Decimal 

j SS,Decimal 

j xj xj 

1 x| X 

jData 

j N 

jN 

i N 

jN 

JMultiply,Extended 

J RR,Floating 

Pt.j j xj E 

j i x 

j B 

j N 

jN 

i N 

jN 

JMultiply Halfword 

j RX 

i 

j X j X j 

1 1 1 

1 1 

1 1 

1 

1 

j N 

i 

jN 

i 

jN 

i 

JN 

i 

JMultiply,Long 

1 

| RX,Floating 

Pt. J xj x| E 

1 1 

1 ! x 

1 

|B 

I 

jN 

1 

j N 

i 

jN 

1 

j N 

jMultiply,Long 

J RR,Floating 

Pt.j jx|E 

j j x 

j B 

JN 

J N 

jN 

jN 

JMultiply,Long 
jto Extended 

1 

j RX,Floating 

1 i 1 

Pt.Jx|x|E 

1 1 
|x|x 

1 

|B 

I 

jN 

1 

jN 

JN 

1 

jN 

JMultiply,Long 
jto Extended 

1 

J RR,Floating 

1 ! 1 

Pt.j | x| E 

1 I 

1 1 X 

I 

j B 

1 

jN 

1 

jN 

1 

jN 

1 

N 

|Multiply,Short 

j RX,Floating 

Pt. j xj xj E 

j j X 

jB 

! N 

JN 

jN 

JN 

JMultiply,Short 

j RR,Floating 

Pt.j j xj E 

j j x 

i B 

|N 

jN 

jN 

j N 

JNo Operation 

i__ 

|RX,Ext.MnemonicJ J | 

_j -- -- l x x - 

1 1 

.X_X— 

1 

x_ 

i n 

_L__ 

jN 

_1_ 

jN 

X _ _ 

jN 
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r - 

1 

1 

|Instruction 

i .. 

|Mnemonic (Machine | Operand Format 

j Operation!Operation! 

jCode (Code J Explicit Implicit 

-L 

-1 

_j 

1 

T 

T 

T 

T 




-1 

|No Operation 

( NOPR 

j 07 (BCR 

0) |R2 






jOr Logical 

|0 

1 56 

(Rl,D2 (X2,B2) or R1,D2(,B2) 


R1 ,S2 (X2) 

or 

R1 

,S 21 

jor Logical 

| oc 

D6 

j D1 (L,B1) , D2 (B2) 


SI (L) ,S2 

or SI, 

S2 J 

jOr Logical 

|W 

I 16 

j R1,R2 






|0r Logical Immediate 101 

1 96 

j D1 (Bl) f 12 


SI,12 




|Pack 

| PACK 

j F2 

j D1 (LI, B1) , D2 (L2 , B2) 


SI (LI) ,S2 (L2) 

or J 


1 

I 

1 

1 


S 1 ,S2 




(Read Direct 

1 

| RDD 

1 

1 8 5 

I 

( D1 (Bl) ,12 


SI,12 




|Set Clock 

| SCK 

(B204 

| D 1 (Bl) 


SI 




jset Program Mask 

| SPM 

| 04 

1 R 1 






jSet System Key 

| SSK 

| 08 

1R 1,R2 





J 

jset System Mask 

| SSM 

| 80 

j D1 (Bl) 


SI 




jShift and Round 

1 

I 

1 






| Decimal 

| SRP 

| F0 

J D1 (LI ,B1) ,D2 (B2) ,M3 


SI (LI) ,S2 

,M3 

or 



1 

1 

( 


S1,S2,M3 




|Shift Left Double 

1 

1 

1 






jAlgebraic 

| SLDA 

1 

| 8F 

1 

j R 1, D2 (B2) 

l 


R1 ,S2 




(Shift Left Double 

i 

i 

1 

1 

i 

! 






| Logical 

j sldl 

j 8D 

j R 1, D2 (B2) 


R1 ,S2 




jShift Left Single 

1 

1 

1 






jAlgebraic 

1 SLA 

j 8B 

j R 1, D2 (B2) 


R1 ,S2 




jShift Left Single 

1 

1 

I 






jLogical 

jSLL 

| 89 

j R 1, D2 (B2) 


R1 ,S2 




jShift Right Double 

1 

1 

1 






jAlgebraic 

| SRDA 

j 8E 

j R 1, D2 (B2) 


R1 ,S2 




|Shift Right Double 

1 

1 

1 






jLogical 

j SRDL 
j 

| 8C 

i 

|R1,D2 (B2) 
j 


R1 ,S2 




jShift Right Single 

1 

i 

i 

i 

i 

l 






(Algebraic 

| SRA 

j 8A 

j R 1,D2 (B2) 


R1 ,S2 




jShift Right Single 

1 

1 

1 






jLogical 

j SRL 

( 88 

| R 1, D2 (B2) 


R1 ,S2 




jStart I/O 

( SIO 

| 9C 1 

1 D 1 (Bl) 


SI 




jStart I/O Fast 

1 

! 

I 






(Release 

| SI OF 

| 9C 1 

(D1 (Bl) 


SI 




(Store 

j ST 

| 50 

j R1, D2 (X2, B2) or Rl,D2(,B2) 


R1,S2 (X2) 

or 

R1 

,S2 | 

jStore Channel ID 

J STIDC 

| B203 

j D1 (Bl) 


SI 




(Store Character 

| STC 

( 42 

JR1,D2 (X2,B2) or R1,D2(,B2) 


R1 ,D2 (X2) 

or 

R1 

,S2 | 

(Store Characters 

1 

1 

1 






(under Mask 

j STCM 

(BE 

JR1,M3,D2 (B2) 


R1,M3,S2 




(Store Clock 

j STCK 

| B205 

1 D 1 (Bl) 


SI 




(Store Control 

(STCTL 

(B6 

|R1,R3,D2 (B2) 

1 

1 

R1,R3,S2 




|Store CPU ID 

|STIDP 

1 

1 B202 

1 

1 D 1 (Bl) 


SI 




(Store Halfword 

1 

| STH 

| 40 

1 

(R1,D2 (X2,B2) or R1,D2(,B2) 


R1 ,S2 (X2) 

or 

R1 

, S 21 

(Store Long 

| STD 

| 60 

(R 1 ,D2 (X2,B2) 


R1 ,S2 (X2) 

or 

R1 

,S2 j 

jStore Multiple 

j STM 

| 90 

jR1 ,R2,D2 (B2) 


R1,R2,S2 




(Store Short 

j STE 

| 70 

(R1,D2 (X2,B2) or R1,D2(,B2) 


R1,S2 (X2) 

or 

R1 

,S21 

j Subtract 

1 s 

I 

1 5B 

j R1, D2 (X2) 

I 


R1 ,S2 (X2) 

or 

R1 

,S21 

j Subtract 

1 

j SR 

1 

1 IB 

(R1,R2 






(Subtract Decimal 

|SP 

| FB 

j D 1 (LI ,B1) , D2 (L2,B2) 


SI (LI) ,S2 (L2) 

or | 


( 

1 

1 


SI ,S2 



1 

(Subtract Halfword 

j SH 

j 4B 

(R1,D2 (X2,B2) or R1,D2(,B2) 


R1 ,S2 (X2) 

or 

R1 

,S2| 

(Subtract Logical 

| SL 

| 5F 

(R1,D2 (X2,B2) or R1,D2(,B2) 


R1 ,S2 (X2) 

or 

R1 

,S2| 

jSubtract Logical 

| SLR 

j IF 

|R1,R2 





1 

|-- 

_J__ _ . 

_ JL__ 

_ _X___ 

zL 


_ 

_ 

-J 


I 1 See Note 2, Figure 16. j 

i-j 
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j Instruction 

(Mnemonic (Machine ( Operand Format | 
jOperation}Operationj j 
(Code (Code j Explicit Implicit j 
j. j. r j 

r --- ” 

|Subtract Normalized, 

r 

1 

r 

1 

T 

1 

T 1 

1 | 

j Extended 

j SXR 

1 37 

|R1,R2 


(Subtract Normalized, 

1 

1 

1 

1 | 

|Long 

| SD 

j 6B 

JR1,D2 (X2,B2) or Rl,D2(,B2) 

j R1 ,S2 (X2) or R1 ,S2| 

jSubtract Normalized, 

1 

1 

1 

i ! 

|Long 

j SDR 

j 2B 

|R1,R2 

1 1 

jSubtract Normalized, 

1 

1 

1 

1 1 

jShort 

| SE 

1 7 B 

(R1,D2 (X2,B2) or R1,D2(,B2) 

| R1 ,S2 (X2) or Rl ,S2 j 

(Subtract Normalized, 

1 

1 

1 

1 1 

j Short 

j SER 

j 3B 

JR1,R2 

I 1 

j Subtract 


1 

1 

1 1 

j Unnormalized,Long 

(SW 

1 

j 6F 

1 

(R1,D2 (X2,B2) or Rl,D2(,B2) 

1 

j Rl ,S2 (X2) or Rl ,S2 j 

! 1 

j Subtract 

1 

1 

1 

I 

1 

1 

! I 

j Unnormalized,Long 

j SWR 

j 2F 

* 

ro 

! 1 

j Subtract 

1 

1 

! 

I 1 

j Unnormalized,Short 

j su 

j 7F 

(R1,D2 (X2,B2) or R1,D2(,B2) 

(Rl ,S2 (X2) or Rl ,S2| 

J Subtract 

1 

1 

1 

i 1 

j Unnprmalized,Short 

jSUR 

j 3F 

(R1,R2 

1 1 

(Supervisor Call 

j SVC 

j 0A 

jl 

1 1 

(Test and Set 

|TS 

i 

1 93 

t 

j D1 (Bl) 

j SI ( 

1 I 

(Test Channel 

i 

(TCH 

1 

j 9F 

i 

j D1 (Bl) 

1 1 

| SI ( 

(Test I/O 

j TIO 

9D 

J D1 (Bl) 

| SI | 

(Test Under Mask 

(TM 

| 91 

j D1 (Bl) ,12 

|SI,12 | 

(Translate 

|TR 

(DC 

j D1 (L,B1) ,D2 (B2) 

iSI (L) ,S2 or S1,S2 j 

(Translate and Test 

j TRT 

l 

|DD 

1 

J Dl (L,B1) ,D2 (B2) 

1 

j SI (L) ,S2 or S1,S2 j 

1 1 

(Unpack 

i 

(UNPK 

1 

JF3 

1 

ID1 (LI ,B1) ,D2 (L2,B2) 

1 1 
|SI (LI) ,S2 (L2) or j 


1 

1 

I 

j SI,S2 j 

(Write Direct 

j WRD 

j 84 

j Dl (Bl) ,12 

j SI,12 | 

(Zero and Add Decimal 

( ZAP 

|F8 

jD1 (LI,Bl) ,D2 (L2,B2) 

j SI (LI) ,S2 (L2) or j 


( 

1 

1 

| SI,S2 | 

i____ 

_J._ 

JL_-_ 

i___ __ 

JL- _ __ J 
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—1-T-1 

| |Program Interruptions | 

j jPossible Condition Code Set 1 


jinstruction 

j Type of 

|—T~T-T r— 

"T- 

“T-- 

r— — 

~T- 

~T~ — - 

| 

jInstruction 

|A|SJOv|P|Op|Other 

J 00 

1 01 

1 10 

1 11 


■L_ _ 


_ J _ J _ J. _X _ L_ 

-4- 

-4 

4 

4 

4 




-r 1 1—T T 

1 

1 

1 

1 

t 

|No Operation 

|RR, 

Ext.MnemonicJ | | | | 

1 

|N 

|N 

jN 

jN 

|Or Logical 

JRX 


| x| x| | | 

1 

jj 

|K 

1 

1 

|Or Logical 

j SS 


i x j j j x j 

1 

jj 

jK 

1 

1 

jor Logical 

j RR 


i i i i i 

1 

j j 

j K 

1 

1 

|Or Logical Immediate 

1 si 


|x| I 1X1 

1 

jj 

j K 

1 

1 

|Pack 

1 

j SS 

1 


jxj j j X j 

III II 

1 

1 

jN 

1 

jN 

1 

jN 

1 

jN 

1 

1 

■JRead Direct 

1 

| SI 


1 1 1 1 1 

|XI | |x|x 

1 

jA 

1 

jN 

1 

jN 

1 

jN 

1 

i n 

|Set Clock 

1 SI 


jxjxj jxjx 

jA 

j AAE 

j AAF 

1 

| AAG 

|Set Program Mask 

| RR 


III II 

1 

jRR 

jRR 

jRR 

jRR 

|Set Storage Key 

j RR 


1 x| x| I 1 X 

jA 

j n 

jN 

j N 

jN 

jset System Mask 

|SI 


|xj j j j 

jA 

jN 

jN 

j N 

jN 

jShift and Round 

1 


III II 

1 

1 

1 

1 

1 

jDecimal 

| SS 


jxj jD Jxj 

jData 

j J 

jL 

|M 

|0 

|Shift Left Double 

1 


1 1 1 1 1 

1 

1 

1 

1 

1 

jAlgebraic 

i 

j RS 
| 


| j xj F I j 
III It 

1 

1 

j J 
| 

jL 

l 

jM 

| 

|0 

1 

1 

jShift Left Double 

1 


ill li 

1 1 1 1 1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

jLogical 

j RS 


1 | xj || 

i 

jN 

jN 

jN 

jN 

jShift Left Single 

1 


III 11 

i 

1 

1 

1 

1 

jAlgebraic 

j RS 


j j |F j 1 

i 

j J 

jL 

jM 

jo 

jShift Left Single 

1 


II 1 1! 

i 

1 

1 

1 

1 

jLogical 

j RS 


1 1 1 1 1 

i 

j N 

jN 

jN 

jN 

jShift Right Double 

1 


II 1 1 1 

i 

1 

1 

1 

1 

|Algebraic 

j RS 


| | x I || 

i 

j J 

jL 

jM 

1 

|Shift Right Double 

1 


III II 

i 

1 

1 

1 

1 

jLogical 
j 

j RS 

i 


1 l x l 1 1 

III 11 

i 

i 

jN 

i 

jN 

1 

jN 

| 

|N 

| 

1 

|Shift Right Single 

1 

1 


III II 

1 I 1 1 1 

i 

i 

1 

1 

1 

1 

1 

1 

1 

1 

jAlgebraic 

j RS 


1 1 1 1 1 

i 

j J 

jL 

|M 

1 

jShift Right Single 

1 


1 1 1 1 1 

i 

1 

1 

I 

1 

jLogical 

j RS 


1 II 1 1 

i 

jN 

jN 

jN 

jN 

jStart I/O 

1 si 


1 1 1 1 1 

jA 

j MM 

|CC 

jEE 

j AA 

jStart I/O Fast 

1 


1 1 1 1 1 

l 

1 

1 

1 

1 

jRelease 

j SI 


1 1 1 1 1 

jA 

j MM 

|CC 

jEE 

jKK 

j Store 

RX 


I x| x| 1 X 1 

1 

jN 

|N 

|n 

jN 

JStore Channel ID 

jsi 


III 1 j x 

jA 

j AAH 

|CC 

j AAI 

jKK 

|Store Character 

j RX 


jxj j jxj 

1 

jN 

jN 

jN 

jN 

jStore Character 

1 


1 1 1 1 1 

1 

1 

1 

1 

1 

|under Mask 

IRS 


|X| 1 f X1 

1 

jN 

jN 

jN 

jN 

jStore Clock 

1 si 


1 x| I I x| X 

1 

j AAJ 

jAAK 

1 

j AAG 

jStore Control 

IRS 


jxjxj jxj 

jA 

JN 

IN 

j N 

| N 

jStore CPU ID 

1 

i SI 

1 


| xj x| jxjx 

III It 

jA 

jN 

l 

j N 

1 

|n 

i 

jN 

|Store Halfword 

1 

j RX 


III II 

I xj x| 1 X [ 

1 

1 

IN 

1 

jN 

1 

jN 

1 

jN 

j Store Long 

|RX, 

Floating 

Pt.jxjxj jxjx 

1 

j N 

jN 

jN 

In 

j Store Multiple 

j RS 


jxjxj jxj 

1 

jN 

|n 

jN 

|n 

j Store Short 

|RX, 

Floating 

Pt.jxjxj jxjx 

1 

jN 

j N 

| N 

jN 

|Subtract 

1 

| RX 

i 


j xj xj F j j 
III II 

1 

1 

jv 

1 

jx 

1 

i* 

1 

|0 

j 

1 

|Subtract 

i 

| RR 


III II 
j j IF 1 I 

1 

1 

1 

jv 

1 

jx 

1 

j Y 

1 

jo 

j Subtract Decimal 

|SS, 

Decimal 

jxj jD jxjx 

jData 

|V 

jx 

\Y 

jo 

j Subtract Halfword 

j RX 


j xj xj F j j 

1 

jv 

jx 

j y 

jo 

j Subtract Logical 

| RX 


jxjxj j j 

1 

1 

|W,H 

|V,I 

|W,I 

jSubtract Logical 

j RR 


1 1 1 1 1 

1 

1 

|W,H 

|V,1 

|W,I 

L 

■ 


J- J- J- -L -L _ 

± 

-L 

_ 1_ 


_4_ 
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1 

1 

1 

jProgram Instructions 
j Possible 

i 

Condition 

Code Set 

__j 

I LiruotlOll 

i 

i i yp e 

jInstruction 

... i,. 

j Ajsiovjpjopjother 

j_ ± j. ± __ 

i 00 
.± _ 

i 01 

4_ 

T 

1 

10 | 11 

4_ 

1 

_J 

|Subtract Normalized, 

1 

r t r i 

1 1 1 

T 

1 

T 

1 

I 

1 

1 

1 

1 

T 

l 

1 

J Extended 

|Subtract Normalized, 

| RR,Floating 

1 

Pt.j j xj E 

1 i i 

1 X 

1 

1 B, C 

1 

JR 

! 

|L 

1 

jM 

1 

l 

l 


|Long 

jSubtract Normalized, 

j RX,Floating 

Pt. jxjxjE 

I 1 I 

t X 

1 

1B, C 

1 

|R 

1 

jL 

1 

jM 

1 

IQ 

1 


|Long 

jSubtract Normalized, 

j RR,Floating 

1 

Pt.j jxjE 

1 1 1 

|x 

1 

|B,C 

1 

| R 

I 

jL 

1 

|M 

1 

IQ 

1 


|Short 

jSubtract Normalized, 

j RX,Floating 

1 

Pt.jxjxjE 

1 1 1 

I X 

1 

1 B,C 

1 

i* 

i 

jL 

1 

|M 

1 

IQ 

1 


j Short 
|Subtract 

J RR,Floating 

1 

Pt.j j xj E 

1 1 i 

jx 

1 

1 B,C 

1 

j R 

1 

jL 

1 

jM 

1 

IQ 

1 


j Unnormalized,Long 

1 

1 

|Subtract 

|RX,Floating 

1 

1 

1 

Pt.jxjxjE 

1 1 i 

1 1 ! 

! 1 1 

|x 

1 

1 

1 

jc 

1 

1 

1 

jR 

1 

1 

! 

jL 

1 

1 

jM 

1 

1 

1 

IQ 

1 

1 


j Unnormalized,Long 
j Subtract 

|RR,Floating 

Pt.j }x j E 

1 i I 

1 X 

1 

jc 

1 

j R 

I 

jL 

1 

jM 

1 

IQ 

1 


j Unnormalized,Short 
j Subtract 

|RX,Floating 

1 

Pt.jxjxjE 

1 1 I 

|x 

1 

|C 

1 

j R 

1 

|L 

1 

jM 

I 

IQ 

1 


J Unnormalized,Short 

|RR,Floating 

Pt.j jxjE 

1 X 

jc 

j R 

jL 

|M 

IQ 


jSupervisor Call 

j RR 

] 1 1 

1 

1 

JN 

j N 

j N 

jN 


|Test and Set 

|SI 

1 

j x| ] 

i i i 

x| 

1 

1 

1 

|SS 

1 

|TT 

i 

1 

| 

1 

j 


1 

|Test Channel 

1 

SI 

1 1 1 
! I 1 

1 

1 

1 

|A 

1 

j JJ 

1 

jll 

|FF 

| HH 


JTest I/O 

SI 

1 1 i 

1 

jA 

|LL 

|CC 

jEE 

j KK 


|Test Under Mask 

j SI 

I x) I 

I 

1 

juu 

jw 

1 

jww 


jTranslate 

jss 

j X j j 

x| 

1 

|N 

|N 

|N 

j N 


jTranslate and Test 

|SS 

1 

1 xj 1 
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Figure 17. Machine 

Instruction Summary (Part 12 

or 14) 
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Program Interruptions Possible 


| Under Ov: | 
j D=Decimal j 
| E=Exponent j 
j F=Fixed Point | 

j Under Other: j 
j A Privileged Operation j 
j B Exponent Underflow j 
j C Significance j 
j D Decimal Divide j 
| E Floating Point Divide j 
j F Fixed Point Divide J 
j G Execute | 
| GA Monitoring j 

jCondition Code Set j 
j H No Carry j 
j I Carry j 
| J Result=0 j 
j K Result is Not Equal to Zero j 
j L Result is Less Than Zero j 
j M Result is Greater Than Zero j 
j N Not Changed j 
j 0 Overflow j 
j P Result Exponent Underflows j 
j Q Result Exponent Overflows j 
J R Result Fraction=0 j 
j S Result Field Equals Zero j 
j T Result Field is Less Than Zero | 
j U Result Field is Greater Than Zero j 
j V Difference=0 j 
j W Difference is Not Equal to Zero j 
j X Difference is Less Than Zero j 
j Y Difference is Greater Than Zero j 
j Z First Operand Equals Second Operand j 
j AA First Operand is Less Than Second Operand j 
j BB First Operand is Greater Than Second Operand j 
| CC CSW Stored | 
j DD Channel and Subchannel not Working j 
j EE Channel or Subchannel Busy j 
j FF Channel Operating in Burst Mode j 
j GG Burst Operation Terminated j 
j HH Channel Not Operational j 
j II Interruption Pending in Channel j 
J <JJ Channel Available J 
j KK Not Operational j 
j LL Available j 
j MM I/O Operation Initiated and Channel Proceeding With its Execution j 
j NN Nonzero Function Byte Found Before the First Operand Field is Exhausted j 
j 00 Last Function Byte is Nonzero j 
j PP All Function Bytes Are Zero j 
j QQ Set According to Bits 34 and 35 of the New PSW Loaded j 
| RR Set According to Bits 2 and 3 of the Register Specified by R1 j 
j SS Leftmost Bit of Byte Specified=0 j 
j TT Leftmost Bit of Byte Specified=1 j 
j UU Selected Bits Are All Zeros; Mask is All Zeros j 
j W Selected Bits Are Mixed (zeros and ones) j 
j WW Selected Bits Are All Ones j 
L-J 

Figure 17. Machine Instruction Summary (Part 13 of 14) 
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Condition Code Set 


XX Selected Bytes are Equal, or Mask is Zero 

YY Selected Field of First Operand is Low 

ZZ Selected Field of First Operand is High 

AAA First-operand and Second-operand Counts are Equal 

AAB First Operand Count is Lower 

AAC First Operand Count is Higher 

AAD No Movement Because of Destructive Overlap 

AAE Clock Value Set 

AAF Clock Value Secure 

AAG Clock not Operational 

AAH Channel ID Correctly Stored 

AAI Channel Activity Prohibited During ID 

AAJ Clock Value is Valid 

AAK Clock Value Not Necessarily Valid 

AAL Channel Working With Another Device 


Figure 16. Machine Instruction Summary {Part 14 of 14) 
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Appendix EL Assembler Instructions 


Operation 

Entry 


|Name Entry 


Operand Entry 


ACTR 

AGO 


|Not used, must not be present 


An arithmetic SETA expresssion 


|A sequence symbol or not present 


A sequence symbol 


H 


AIF 


h 
V 

[— 

ccw 

I- 

CNOP 


jA sequence symbol or not present 


A logical expression enclosed in 
parentheses, immediately followed by a 
sequence symbol 


ANOP 


j A sequence symbol 


Not used, must not be present 


H 


|Any symbol or not present 


Four operands, separated by commas 


h 
I 

K 

I 

j.-- 

CSECT 

I- 

DC 

K- 


j A sequence symbol or not present 


Two absolute expressions, separated by a 
comma 


COM 

COPY 


jA sequence symbol or not present 


Not used, should not be present 


j Not used, must not be present 


A symbol 


|Any symbol or not present 


NOt used, should not be present 


JAny symbol or not present 


One operand 


DROP 


jA sequence symbol or not present 


One to sixteen absolute expressions, 
separated by commas 


DS 

DSECT 


|Any symbol or not present 


One operand 


f-- 

EJECT 


jA variable symbol or an 
jordinary symbol 


Not used, should not be present 


H 


|A sequence symbol or not present 


Not used, should not be present 


END 


I- 

ENTRY 


j A sequence symbol or not present 


A relocatable expression 
or not present 


EQU 


|A sequence symbol or not present 


One or more relocatable symbols, 
separated by commas 


j A variable symbol or an 
j ordinary symbol 


An absolute or relocatable expression 


EXTRN 


j A sequence symbol or not present 

I 


One or more relocatable symbols, 
separated by commas 


GBLA 


jNot used, must not be present 


One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 


GBLB 


|Not used, must not be present 

I 


One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 


| SET 

L- 


symbols may be defined as subscripted SET symbols. 


(Part 1 of 3) 
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r- t 

Operation 
Entry 

h 


Name Entry 


Operand Entry 


GBLC 


Not used, must not be present 


One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 


ICTL 


Not used, must not be present 


One to three decimal values, separated by 
commas 


ISEQ 


Not used, must not be present 


Two decimal values, separated by a comma 


LCLA 


Not used, must not be present 


One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 


LCLB 


Not used, must not be present 


One or more variable symbols that are to 
be used as SET symbols, separated by 
commas 1 


LCLC 


Not used, must not be present 


One or more variable symbols separated by 
commas 1 


LTORG 


Any symbol or not present 


Not used, should not be present 


MACRO ; 


Not used, must not be present 


Not used, should not be present 


MEND 2 


A sequence symbol or not present 


Not used, must not be present 


MEXIT 2 


A sequence symbol or not present 


Not used, must not be present 


MNOTE 2 


A sequence symbol, a variable 
symbol or not present 


A severity code, followed by a comma, 
followed by any combination of characters 
enclosed in apostrophes 

H 


ORG 

PRINT 

PUNCH 


A sequence symbol or not used 


A relocatable expression or not used 


A sequence symbol or not present 


One to three operands 


A sequence symbol or not present 


One to 80 characters enclosed in 
apostrophes 


REPRO 

SETA 

SETB 


A sequence symbol or not used 


Not used, must not be present 


H 


SETA symbol 


An arithmetic expression 


A SETB symbol 


A 0 or a 1, or logical expression 
enclosed in parentheses 


H 


SETC 


A SETC symbol 


A type attribute, a character expression, 
a substring notation, or a concatenation 
of character expressions and substring 
notations 


SPACE 


A sequence symbol or not present 


A decimal self-defining term or not used 


START 


Any symbol or not present 


A self-defining term or not used 


1 SET 

2 May 


symbols, may be defined as subscripted SET symbols, 
only be used as part of a macro definition. 


(Part 2 of 3) 
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jOperation | 

j Entry j Name Entry 


Operand Entry 


|TITLE 1 2 3 JA special symbol (0 to 4 charac- 

j jters), a sequence symbol, a 

j jvariable symbol, or not present 


One to 100 characters, enclosed in 
apostrophes 


!USING 


| A sequence symbol or not present 


An absolute or relocatable expression 
followed by 1 to 16 absolute expressions, 
separated by commas 


|WXTRN* 


|A sequence symbol or not present 


One or more relocatable symbols, 
separated by commas 


j 3 See Section 5 for the description of the name entry. 
| 4 DOS Assembler 14K D only. 


ASSEMBLER STATEMENTS 


(Part 3 of 3) 


INSTRUCTION 


NAME ENTRY 


|OPERAND ENTRY | 

4 -„-^ 

|Any combination of charactersj 

| (including variable j 

jsymbols) j 


Model Statements 1 2 
(A variable symbol or any 
assembler language mnemonic 
operation code except COPY, 
END, ICTL, ISEQ, and PRINT) 


An ordinary symbol, variable 
symbol, sequence 
symbol, a combination of 
variable symbols and other 
characters that is equivalent 
to a symbol, or not used 


Prototype Statement 3 


A symbolic parameter or 
not used 


Zero or more operands that 
are symbolic parameters, 
separated by commas, followed 
by zero or more operands 
(separated by commas) of the 
form symbolic parameter, 
equal sign, optional standard 
value 


Macro Instruction 
Statement 3 


An ordinary symbol, a 
variable symbol, a sequence 
symbol, a combination of 
variable symbols and other 
characters that is equivalent 
to a symbol, 4 or not used 


Zero or more positional 
operands separated by commas, 
followed by zero or more 
keyword operands (separated 
by commas) of the form 
keyword, equal sign, value 4 


Assembler Language 
Statement 1 3 


An ordinary symbol, a var¬ 
iable symbol, a sequence 
symbol, a combination 
of variable symbols and 
other characters that is 
equivalent to a symbol, 
or not used 


Any combination of characters 
(including variable symbols) 


1 Variable symbols may not be used to generate the following mnemonic operation codes: 
ACTR, COPY, END, ICTL, CSECT, DSECT, ISEQ, PRINT, REPRO, and START. Variable symbols 
may not be used in the name and operand entries of the following instructions: COPY, 
END, ICTL, and ISEQ. Variable symbols may not be used in the name entry of the ACTR 
instruction. 

2 The line following a REPRO statement may not contain variable symbols. 

3 May only be used as part of a macro definition. 

4 Variable symbols appearing in a macro instruction are replaced by their values before 
the macro instruction is processed. 
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Appendix F. Summary of Constants 


T-1 

TRUN¬ 
CATION/ 
PADDING 
SIDE 


TYPE 

AND 

DELIM. 


IMPLIED 

LENGTH 

(BYTES) 


ALIGN¬ 

MENT 


LENGTH 

MODI¬ 

FIER 

RANGE 


SPECIFIED 

BY 


CON¬ 

STANTS 

PER 

OPERAND 


RANGE 
FOR EX¬ 
PONENTS 


RANGE 

FOR 

SCALE 


C • 


as 

needed 


byte 


1 to 
256* 


characters 


one 


right 


-.j 


as 

needed 


byte 


1 to 
256 1 


hexadecimal 

digits 


one 


left 


H 


as 

needed 


byte 


1 to 
256 


binary 

digits 


one 


left 


F ' 


word 


1 to 8 


decimal 

digits 


multiple 


-85 to 
+75 


-187 to 
+ 346 


left 


H 


H ' 


half 

word 


1 to 8 


decimal 

digits 


multiple 


-85 to 
+75 


-187 to 
+ 346 


left 


E ' 


word 


1 to 8 


decimal 

digits 


multiple 


-85 to 
+75 


0 to 14 


right 


D ' 


double 

word 


1 to 8 


decimal 

digits 


multiple 


-85 to 
+75 


0 to 14 


right 


L 2 

j.- 

P r 


16 


double 

word 


1 to 
16 


decimal 

digits 


+- f -f-f- 


as 

needed 


byte 


1 to 
16 


decimal 

digits 


multiple 

+- 

multiple 


-85 to 
+ 75 
i- 


0 to 28 
+- 


right 

left 


+--I 


as 

needed 


byte 


1 to 
16 


decimal 

digits 


multiple 


left 

left 


A ( ) 


word 


1 to 4 


an absolute 
expression 


multiple 


3 or 4 


a relocatable 
or complex 
relocatable 
expression 


-f 


V ( ) 


word 


3 or 4 


relocatable 

symbol 


multiple 


left 


S ( ) 


half 

word 


2 only 


one absolute 
or relocatab¬ 
le expression 
or two abso¬ 
lute expres¬ 
sions: 
exp (exp) 


multiple 


—i-x-1 

length specification 


1 In a DS assembler instruction, C and X type constants may have 
to 65535. 

2 DOS Assembler D, 14K variant only. 


(Part 1 of 2) 
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(TYPE 

(AND 

IDELIM. 

f- 

|Y ( ) 


IMPLIED 

LENGTH 

(BYTES) 


j LENGTH 
| MODI- 
ALIGN-j FIER 
MENT I RANGE 


SPECIFIED 

BY 


jCON- 
|STANTS 
| PER 

j OPERAND 


RANGE 
FOR EX¬ 
PONENTS 


RANGE 

FOR 

SCALE 


TRUN¬ 

CATION/ 

PADDING 

SIDE 


half j 1 or 2 
word j 

F- 

J 2 only 
l 


an absolute jmultiple 
expression J 

--J 

a relocatable! 
or complex ! 
relocatable j 
expression j 
- x - 


(Part 2 of 2) 
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Appendix G. Macro Facility Summary 


The four charts in this appendix summarize 
the macro facility described in Part 2 of 
this publication. 

Figure 18 indicates which macro facility 
elements may be used in the name and 
operand entries of each statement. 

Figure 19 is a summary of the 
expressions that may be used in macro 
instruction statements. 


Figure 20 is a summary of the attributes 
that may be used in each expression. 


Figure 21 is a summary of the variable 
symbols that may be used in each 
expression. 



Variable Symbols 






Global SET Symbols 

. _ 

Local SET Symbols 



Attributes 


Statement 

Symbolic 

Parameter 

SETA 

SETB 

SETC 

SETA 

SETB 

SETC 

&SYSNDX 

iSYSECT 

&SYSUST 

Type 

Length 

Scaling 

Integer 

Count 

Number 

Sequence 

Symbol 

MACRO 


















Prototype 

Statement 

Name 

Operand 

















GBLA 


Operand 
















GBLB 



Operand 









BH 

■Mil 





GBIC 












■ 

1 





tCLA 





Operand 













LCLB 






Operand 



















Operand 












Name 

Operation 

Operand 

Name 

Operation 

Operand 


Nome 

Operation 

Operand 


Nome 

Operation 

Operand 

Nome 

Operation 

Operand 

Nome 

Operation 

Operand 

Operation 

Operand 

Name 

Operation 

Operand 

■ 

■ 


■ 

■ 

■ 

]§■ 


















Name 

SETA 

Operand^ 

Name 

Operand 

Operand'* 

Operand^ 

Name 

Operand 

3 

Operand 

Operand^ 

Operand 

■ 


| 

Operand 

Operand 

Operand 

Operand 

Operand 


SETB 





Operand^ 

Nome 

Operand 

Operand^ 

Operand^ 

Operand 4 

Operand^ 

Operand 4 

Operand^ 

Operand^ 

Operand^ 

Operand^ 

Operand^ 


SETC 

Operand 


Operand® 

Name 

Operand 

Operand^ 

o 

Operand 

Nome 

Operand 

Operand 

Operand 

Operand 

Operand 








Operand^ 

Operand^ 

Operand 

Operand^ 

Operand^ 

Operand 

Operand^ 

Operand^ 

Operand 4 

Operand^ 

Operand 4 

Operand^ 

Operand^ 

Operand^ 

Operand ^ 

Operand^ 

Name 

Operand 

AGO 

















Name 

Operand 

ACTR 

Operand^ 

Operand 

Operand^ 

Operand^ 

Operand 

Operand^ 

Operand^ 

Operand 


Operand^ 


Operand 

Operand 

Operand 

Operand 

Operand 


A NOP 

















Name 

MEXIT 






■ 











Name 

MNOTE 

Operand 

Operand 



Operand 

Operand 

Operand 

Operand 

Operand 

Operand 








MEND 


















Outer 

Macro 


Name 

Operand 

Nome 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 










Nome 

Inner 

Macro 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 

Name 

Operand 








Assembler 

Language 

Statement 


Name 

Operation 

Operand 

Name 

Operation 

Operand 

Name 

Operation 

Operand 

Name 

Operation 

Operand 

Name 
Operation 
Ope rood 

Name 

Operation 

Operand 










Name 


1. Variable symbols in macro-instructions are replaced by their values before processing. 

2. Only if value is self-defining term. 

3. Converted to arithmetic +1 or +0. 

4. Only in character relations. 

5. Only in arithmetic relations. 

6. Only in arithmetic or character relations. 

7. Converted to unsigned number. 

8. Converted to character 1 or 0. 

9. Only if one to eight decimal digits. 


Figure 18. Macro Facility Elements 
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{Expression {Arithmetic Expressions {Character Expressions {Logical Expressions 

h 


May 

contain 


1. Self-defining terms 

2. Length, scaling, 
integer, count, and 
number attributes 

3. SETA and SETB symbols 

4. SETC symbols whose 
value is 1-8 decimal 
digits 

5. Symbolic parameters 
if the corresponding 
operand is a self- 
defining term 

6 SSYSLIST (n) if the 

corresponding operand 
is a self-defining 
term 

7. SSYSLIST (n,m) if the 
corresponding operand 
is a self-defining 
term 

8. SSYSNDX 


1. Any combination of 
characters enclosed 
in apostrophes 

2. Any variable symbol 
enclosed in apos¬ 
trophes 

3. A concatenation of 
variable symbols and 
other characters 
enclosed in apos¬ 
trophes 

4. A request for a type 
attribute 


1. SETB symbols 

2. Arithmetic relations 1 

3. Character relations 2 


Operators 

are 


and / 

parentheses permitted 


concatenation , w:j.th 
period (. > 


AND, OR, and NOT 
parentheses permitted 


Range 
of values 
\ - 


-2 31 to +2 31 -1 


0 through 127 (255 for 
assembler F) characters. 


0 (false) or 
1 (true) 


H 


May be 
used in 


1. SETA operands 

2. Arithmetic relations 

3. Subscripted SET 
symbols 

4. 6SYSLIST 

5. Substring notation 

6. Sublist notation 

7. SETC operands 

8. ACTR operands 


1. SETC operands 3 

2. Character relations 2 

3. SETA operands'* 


1. SETB operands 

2. AIF operands 


An arithmetic relation consists of two arithmetic expressions related by the 
operators GT, LT, EQ, NE, GE, or LE. 

A character relation consists of two character expressions related by the operator 
GT, LT, EQ, NE, GE, or LE. The type attribute notation and the substring notation 
may also be used in character relations. The maximum length of the character 
expressions that can be compared is 127 (255 for assembler F) characters. If the two 
character expressions are of unequal length, then the shorter one will always compare 
less than the longer. 

Maximum of eight characters will be assigned. 

If one to eight decimal digits. 


Figure 19. 


Expressions 
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Attribute 


Notation 


May be used with: 


May be used only if 
type attribute is: 


May be used in 


Symbols outside 
macro definitions; 
symbolic parameters, 
SSYSLIST (n) , and 
SSYSLIST (n,m) inside macro 
definitions 


(May always be 
used) 


1. SETC operand 
fields 

2. Character 
relations 
(SETB) 


Length 


Symbols outside 
macro definitions; symbolic 
parameters, SSYSLIST (n) , and 
SSYSLIST (n,m) inside macro 
definitions 


Any letter except 
M,N,0,T, and U 


Arithmetic 

expressions 


Scaling 


Symbols outside 
macro definitions; symbolic 
parameters, SSYSLIST (n) , and 
SSYSLIST (n,m) inside macro 
definitions 


H,F,G,D,E,K,L,P, 
and Z 


Arithmetic 

expressions 


Integer 


Symbols outside 
macro definitions; symbolic 
parameters, SSYSLIST (n), and 
SSYSLIST (n,m) inside macro 
definitions 


H,F,G,D,E,K,L,P, 
and Z 


Arithmetic 

expressions 


Count 


Symbolic parameters 
corresponding to macro 
instruction operands, SSYSLIST 
(n) , and SSYSLIST (n,m) inside 
macro definitions 


Any letter 


Arithmetic 

expressions 


Number 


Symbolic parameters, 
SSYSLIST, and SSYSLIST (n) 
inside macro definitions 


Any letter 


Arithmetic 

expressions 


Figure 20.. Attributes 
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Variable 

symbol 


Defined by: 


Initialized, 
or set to: 


+ - 

(Constant 

throughout 

definition) 


Value changed 
by: 


May be used in: 


Symbolic* 

Parameter 


I- 

SETA 


Prototype 

statement 


Corresponding 
macro instruction 
operand 


1. Arithmetic expressions 
if operand is self- 

defining term 

2. Character expressions 


LCLA or GBLA 
instruction 


SETA 

instruction 


1. Arithmetic expressions 

2. Character expressions 


SETB 


LCLB or GBLB 
instruction 


SETB 

instructions 


1. Arithmetic expressions 

2. Character expressions 

3. Logical expressions 


SETC 


I- 

6SYSNDX* 


LCLC or GBLC 
instruction 


Null character 
value 


SETC 

instruction 


1. Arithmetic expressions 
if value is one to 
eight decimal digits 

2. Character expressions 


The assembler 


Macro instruction 
index 


(Constant 
throughout 
definition; 
unique for 
each macro 
instruction) 


1. Arithmetic expressions 

2. Character expressions 


6SYSECT* 


The assembler 


Control section 
in which macro 
instruction 
appears 


(Constant 
throughout 
definition; 
set by CSECT, 
DSECT, and 
START) 


Character expressions 


6SYSLIST* 


The assembler 


Not applicable 


Not applicable 


N* 6SYSLIST in arithmetic 
expressions 


SSYSL1ST (n) * 
6SYSLIST (n,m) * 


The assembler 


Corre sponding 
macro instruction 
operand 


(Constant 

throughout 

definition) 


Arithmetic expressions 
if operand is self¬ 
defining term 
Character expressions 


SSYSPARM 


The assembler 


Value specified 
in the OPTION 
job control 
statement 


(Constant 

throughout 

assembly) 


Arithmetic expression 
if value is one to 
eight decimal digits 
Character expressions 


| 1 May only be 

i_ 


used in macro definitions. 


._j 


Figure 21. Variable Symbols 
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Appendix H. Dictionary and Source Statement Sizes 


Part 1. Dictionaries Used in Macro Generation 

A. Dictionaries at Collection Time 


Two or more dictionaries must be constructed to enable the macro 
generator portion of the assembler to accomplish macro generation and 
conditional assembly: a global dictionary and one or more local 
dictionaries. 


Global Dictionary 


A global dictionary containing macro instruction mnemonics and global 
SET variable names is built for the entire program. Dictionary entries 
are fitted into blocks of fixed size, 256 bytes for Assembler (E) and 
1024 bytes for Assembler (F) 

Each block contains complete entries. If an entry cannot fit into the 
remainder of one block, it is put into the next block and bytes in the 
remainder are not used. The sizes of various kinds of dictionary 
entries are as follows: 


(Macro Mnemonic Operation Code 


I Global SET Variable Name 


Fixed Overhead 


10 bytes plus mnemonic 1 
8 bytes plus mnemonic 1 


(Assembler F) 
(Assembler E) 


6 bytes plus name 1 (Assembler F) 

8 bytes plus name 1 (Assembler E) 

(A dimensioned global SET variable is 
counted only once) 

8 bytes for first block 

4 bytes for each succeeding block 

5 bytes for last block 


j 1 One byte is used for each character in the name or mnemonic. 

i___ 


The maximum size of the global dictionary is 64 blocks. In addition, 
the maximum number of distinct global symbols for the Assembler (D) is 
400. (SSYSPAEM is counted in the 14K variant.) 


Local Dictionary 

A local dictionary containing ordinary symbols relevant to macro 
generation and conditional assembly, sequence symbols and local SET 
variable names is constructed for the main portion of the program. In 
addition, a local dictionary containing an entry for each local SET 
variable name, sequence symbol and prototype symbolic parameter declared 
within a macro definition is constructed for each different macro 
definition used in the program. Dictionary entries are fitted into 
blocks of fixed size, 256 bytes for Assembler (D) and 1024 bytes for 
Assembler (F) . 

Each block contains complete entries. If an entry cannot fit into the 
remainder of one block, it is put into the next block and bytes in the 
remainder are not used. The sizes of various kinds of dictionary 
entries are as follows: 
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Sequence Symbol Names 


Local SET Variable Names 


I 


Prototype Symbolic Parameters 

Relevant ordinary symbols 
|appearing in the main 
portion of the program 

I Fixed Overhead 


10 bytes plus name 4 (When defined.) 

10 bytes plus name 4 (When first 
referenced.) 

6 bytes plus name 4 (A dimensioned local 
SET variable is counted only once.) 

5 bytes plus name 4 

10 bytes plus name 4 


8 bytes for first block (32 bytes if a 
macro local dictionary) 


j 5 bytes for last block 
j.- j --J 

J 1 One byte is used for each character in the name or mnemonic. 

L___ 


The maximum size for the local dictionary is 64 blocks. 









B. Dictionaries at Generation Time 


To conserve storage during the actual conditional assembly and macro 
generation, the contents of the Global Dictionary and Local Dictionaries 
are restructured as follows: 


Global Dictionary 


(N=dimension) 


Fixed Overhead 

Macro Mnemonic Operation Code 
Global SETA dimensioned 
Global SETA undimensioned 
Global SETB dimensioned 

Global SETB undimensioned 
Global SETC dimensioned 
Global SETC undimensioned 


4 bytes plus word alignment 

3 bytes 

1 byte plus 4N 

4 bytes 

1 byte plus (N/8) 

[N/8 is rounded to the next 
highest integer] 

1 byte 

1 byte plus 9N 
9 bytes 


Local Dictionary 


(N=dimension) 


Fixed Overhead 


Sequence Symbols 


Local SETA dimensioned 
Local SETA undimensioned 
Local SETB dimensioned 

Local SETB undimensioned 

Local SETC dimensioned 

Local SETC undimensioned 

Relevant ordinary symbols 
appearing in the main portion 
of the program (see Note) 


20 bytes plus word alignment 
for the' F assembler 
27 bytes plus word alignment 
for the D assembler 


5 bytes (when the size of the 

dictionary (see below) is less than 
3000, only the first 40 symbols will 
require 5 bytes each) 

1 byte plus 4N 

4 bytes 

1 byte plus (N/8) 

[N/8 is rounded to the next 
highest integer] 

1 byte 

1 byte plus 9N 

9 bytes 


5 bytes 
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Note: For the D assembler, only those ordinary symbols which appear in 
macro instruction operands are included in this table; for the F 
assembler, all ordinary symbols are included. As a result, the F 
assembler may overflow the Local Dictionary before the D assembler. 


The restructured Global Dictionary and the restructured Local 
Dictionary for the main portion of the program must be resident in main 
storage. 


In addition, if the program contains any macro instructions, main 
storage is required for the largest Local Dictionary of the macro 
definitions being processed. Furthermore, if any macro definitions 
contain inner macro instructions, main storage is required for all the 
restructured Local Dictionaries of all the macros in the nest. 

In addition to those requirements specified above for the Local 
Dictionary of the main portion of the program, each macro definition 
Local Dictionary requires the following for the parameter table: 


r- T -1 

| Fixed Overhead 1 22 bytes | 



Table Entries 


j.- T -—J 


a. 

Character string 

j 3 bytes 

plus 

L 

b. 

Hexadecimal, binary, 
decimal, and character 
self-defining values 

| 7 bytes 

plus 

L 

c. 

Symbol 

| 9 bytes 

plus 

L 

d. 

Sublist 

j 10 bytes 
± 

plus 

2N bytes plus Y 

L=Length of entry 





N=Number of entries in sublist 

Y=Total length of table entries of a., b., and c. formats 


Each nested macro instruction also requires the following: 


r - T - 

| Parameter pointer list | 2 bytes plus 2N 

I I 

jPointers to list in table j 8 bytes plus word alignment 

j.-j.- 

|N=the number of operands. 

i- 


I 

I 

! 

A 


.j 


The size of the dictionary depends on the partition size and the 
assembler variant used. Maximum dictionary sizes for Assembler (D) 
variants in the smallest possible partitions are as follows (in bytes): 


1 w 

» o 

1 Q 

Assembler 

(D) 

Partition 

Variant 

size | 

1 

| 

10K 

- T — 

1 

1 

1 

.1 _ 

12K 

-T— 

1 

1 

! 

.4_ 

14K 

— 1 

1 

1 

1 

_ L_ 

16K 

—l 

_j 

10K 

with tape 

work 

files 

I 

2050 

T— 

1 

f 

3100 

i 

1 

1 

4150 

T 

1 

5000 

1 

iok 

with disk 

work 

files 

1 

1 

1 

1500 

1 

1 

i 

2400 

1 

1 

1 

3600 

1 

1 

4400 


14K 




1 

1 

-_ X- 

- 

1 

! 

.X _ 

- 

1 

I 

-J— 

2750 

1 

1 

-X- 

3800 

_ j 
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Part 2. Macro Mnemonic Table (D Assembler Only) 


As the source text is scanned, a table of macro mnemonics is constructed. There is 
an entry for each macro used or defined as a programmer macro in the program. The 
entries are made under the premise that every undefined operation is a system macro 
mnemonic. This table is then subsetted to locate and edit system macros from the 
library. 

An entry in this subsetted table consists of 9 bytes. With 10,240 or 14,336 
contiguous bytes of main storage available (see “Machine Features Required"), 
approximately 450 distinct macro mnemonics can be handled. When this table 
overflows, processing continues with only those macros defined at that point. If 
additional storage is available, this table is expanded accordingly. 


Part 3. Source Statement Complexity-Conditional Assembly and Macro Generation 

For any statement except macro prototype or macro instructions, a counter is 
increased by one for each literal occurrence of the following: 

1. Ordinary Symbol 

a. Name, operation, or operand entry (when the operand count starts, the 
counter is decremented by one), or 

b. Operand of an EXTRN or WXTRN statement, or 

c. Operand of an attribute operator (L',T , ,1*, etc.) in a SETA, SETB or SETC 
expression, or 

d. Operand of a machine or assembler instruction (only if in the main portion 
of the program) 

2. Variable Symbol 

3. Sequence Symbol 

Note 1 : The maximum value the counter may attain is 35 for the D assembler and 50 
for the F assembler. 

Note 2 : This restriction applies to the name and operation entry of a macro 
instruction or prototype taken as a unit. Each macro instruction or prototype 
operand (in sublist, each sublist operand) is also subject to the counter 
restriction. 

Examples of counts: 

1. SB2 SETB (T 1 NAME EQ'W' OR 'PC'.'A* EQ'AA') count=3 

2. EXTRN A, B, C, &C count=4 


Part 4. Source Statement Complexity-Assembler Statements 

A. D Assembler 


With 10,240 or 14,336 contiguous bytes of main storage available (see "Machine 
Features Required"), the size of any statement must be less than a certain limit. 
This limit is: 

1. 727 bytes for DC or DS statements. 

2. 743 bytes for all other statements. 
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There are two formulas used to estimate the size (in bytes) of a statement. 
The greater of the two calculated values (S, or S 2 ) determines whether the 
statement is less than the given limit. In general, all statements can be 
processed if they contain 50 or fewer terms. If a statement contains more than 
50 terms, the formulas should be used to determine if the statement can be 
processed, or if the statement should be shortened using EQU assembler 
instructions. (In the example for S 1# if A+(B-C) *3 were equated to a symbol, 
that symbol could be used as the displacement field of the first operand.) The 
formulas for statement size. Si and S 2 , follow. 


51 “ N B * n d + “(Nls * n sd> * 6(N S + n l> 

N b = the total number of bytes in name, operation, operand, and comments 
entries. (The maximum value of N B is 187.) 

N n = the number of operators and delimiters in the operand entry [except 
equal (=) , period (.) , and apostrophe (‘) ] . 

N ls = the number of references to length attribute (L*SYMBOL) . 

n SD = the nun *b er °f self-defining terms. 

N s = the number of symbolic terms (including *) . 

N l = the number of literal operands. (The maximum is 1.) 

Example: 

NAME MVC A+ (B-C) *3 (L'D,5) , = 1 5CL5 ' ABCDEFG ' 

S<, =39+9+4 (1 + 4) +6 (3+1) 

=92 bytes 

5 2 = N b + 9 (W, + W 2 +.+ W ± + N e ) + N ed 

N b = the total number of bytes in name, operation, operand, and comments 
entries. (The maximum value of N B is 187) . 

W, + W 2 .+Wi = a we ^9^ lt associated with the 1st, 2nd, 

.,i tn expression. 

Wf = 1, if the expression is: 

a. absolute, 

b. simply relocatable, or 

c. in error. 

If the expression is complexly relocatable, depends on the number of 
unpaired control section numbers (N esd ) . 


!- — - 


T 

'1 

I n esd 

I. 


J Wi 


I 

II 


j 1 


| 2, 3, 4, OR 

5 

1 2 


j 6, 7, 8, OR 

9 

I 3 


I 10, 11, 12, 

OR 

13 | 4 


j14, 15, OR 

16 

1 5 


L 



-J 


N e = the number of expressions. 

Ned = the number of expression delimiters. 

The rules for counting the number of expressions (N E ) and the number of 
expression delimiters (Ned) are: 

1. Expression delimiters are commas and the terminating blank of an operand. 

2. Left and right parentheses can be part of an expression or can be 
expression delimiters. A left or right parenthesis is an expression 
delimiter if it ends an expression. Otherwise, it is part of an expression. 
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Example 1 : The operand is: 


5,6,A+20*B (6,7) 

The expression delimiters are the three commas, the left parenthesis [ (] , the 
right parenthesis ()] , and the terminating blank. 

The first, second, fourth, and fifth expressions all have a weight of 1. The 
third expression in the operand [A+20*B] has a weight of 1 (either B is absolute, 
making the result absolute or simply relocatable or, B is relocatable so the 
expression is in error. 

S 2 = n b + 9 (W x + W 2 + w 3 + W 4 + W 5 + N e ) + N ed 
S 2 =N b +9(1 + 1 + 1 + 1 + 1 + 5) + 6 
S 2 = N B + 96 bytes 
Example 2 : The operand is: 

A+17* (C-D) , (A+20) 

The number of expressions (N E ) is 2. The first expression is A+17*(X-D) . The 
second expression is (A+20) 


The number of expression delimiters (N ED ) is 2 (the comma and the terminating 
blank) . 


Example 3 : The operand is: 


20 (,3) ,16 (5) 


There are 5 expressions and 7 expression 


delimiters. 


Expression 1 = 20 
Expression 2 = 5 
Expression 3 = 3 
Expression 4 = 16 
Expression 5 = 5 


B. F Assembler 


Expression Delimiter 1 = ( 
Expression Delimiter 2 = , 
Expression Delimiter 3 = ) 
Expression Delimiter 4 = , 
Expression Delimiter 5 = ( 
Expression Delimiter 6 = ) 
Expression Delimiter 7 = blank 


1. Generated statements may not exceed 272 characters. Statement length 
includes name, operation, operand, and comments. If a comments field 
exists, the blank separating the operand and the comments field is included 
in the statement length. The statement is truncated if it exceeds 272 
characters. 


2. DC, DS and literal DCs cannot contain more than 32 operands per statement. 


Part 5. Print Control Statement Listing Restrictions 


TITLE, SPACE and EJECT statements will not appear in the source listings unless the 
statement is continued onto another card. Then the first card of the statement will 
be listed. If any of these three statements are generated by macro expansion, they 
will not be listed (regardless of continuation) if the current PRINT option is NOGEN. 
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Appendix L Sample Program and Assembler Listing Description 


The assembler listing consists of five 
sections, ordered as follows: external 
symbol dictionary items; the source and 
object program statements; relocation 
dictionary i.tsms j symbol cress - rone 
table; and diagnostic messages. 


The following sample program illustrates 
an actual assembler listing. Several 
errors have been included to show their 
effect on an assembly. 


Given : 

1. A TABLE with 15 entries, each 16 bytes long, having the following format: 


NUMBER 

of 

items 

— r — - — — 

| SWITCHes 

L 

T-- 

j ADDRESS 

i ^ 

r-- 

j NAME 

A _ _ 

3 bytes 



1 byte 

4 bytes 

8 bytes 

2. A LIST 

of 

items. 

each 16 bytes long 

, having the following format: 

NAME 

T 

1 

_ 1 _ 

SWITCHes 1 NUMBER 

__ _ _J___ 

T 

of items I 

___j _ 

ADDRESS 


8 bytes 1 byte 3 bytes 4 bytes 


Find: Any of the items in the LIST which occur in the TABLE and put the SWITCHes, 

NUMBER of items, and ADDRESS from that LIST entry into the corresponding TABLE entry. 

If the LIST item does not occur in the TABLE, turn on the first bit in the SWITCHes byte 
of the LIST entry. 

The TABLE entries have been sorted by their NAME. 
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This column contains symbols that 
appear in the name field of CSECT or 
START statements, as operands of 
ENTRY, EXTRN, and WXTRN statements, or 
in the operand field of V-type address 

This column contains the type 
designator for the entry, as shown in 
the table. The type designators are 
defined as: 

SD—names section definition. The 

symbol appeared in the name field 
of a CSECT or START statement. 

LD—The symbol appeared as the 

operand of an ENTRY statement. 

ER—external reference. The symbol 
appeared as the operand of an 
EXTRN statement, or was defined 
as a V-type address constant. 

PC—unnamed control section 
definition. 

CM—common control section 
definition. 

WX—weak external reference. The 

symbol appeared as the operand of 
a WXTRN statement. 

This column contains the external 
symbol dictionary identification 
number (ID) . The number is a unique 
two digit hexadecimal number 
identifying the entry. It is used by 
the LD entry of the ESD and by the 
relocation dictionary to cross 
reference to the ESD. 



EXTERNAL SYMBOL DICTIONARY 


This section of the listing contains the 
external symbol dictionary information 
passed to the linkage editor in the object 
module. The entries describe the control 
sections, external references, and entry 
points in the assembled program. There are 
five types of entries, shown along with 
with their associated fields. The circled 
numbers refer to the corresponding heading 
in the sample listing. 
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© ® 

EXAM SAMPLE PROGRAM 


© 

PAGE 1 


/p\ 

LOC OBJECT CODE 


/Ov 

vUj 


© 

A0DR1 ADOR2 


ERROR 


© 


© 

© 

© 

STMT 

SOURCE STATEMENT DOS CL3-0 

09/16/67 

2 




SAMPL001 

3 

* 

THIS 

IS THE MACRO DEFINITION * 

5AMPL002 

4 




SAMPLOO3 

5 


MACRO 


SAMPL0U4 

6 


MOVE 

ET0.EFR0H 

SAMPL005 

7 

A • 



SAMPL006 

A 

c ft 

DEFINE SETC SYMBOL 

SAMP!, DO 7 

9 

* ft 



SAKPL003 

10 


LCLC 

ETYPE 

SAMPLOO'J 

11 

• * 



SAMPLOlU 

12 

• * 

CHECK 

NUMBER OF OPERANDS 

SAMPL Oil 

13 

• * 



SAMPL012 

14 


AIF 

(N'ESYSL1ST NE 2).tRRORl 

SAMPL 01 3 

15 

• * 



SAMPLOI4 

16 


CHECK 

TYPE ATTRIBUTES OF OPERANDS 

SAMPLO 16 

17 

. ft 



SAMPLOI6 

iO 


Air 

ii'biu nc i • {.rKuri ) * ckkuk^ 

5ANKLUI ( 

19 


AIF 

(T • ETO EQ *C' OR T'tTO EG *G' OR T'ETO E0•K•).TYPECGK 

SAMPLOIB 

20 


AIF 

(T'ETO EQ *D• OR T'ETO EQ •£' UR T'ETO E0'H*).TYPEDEH 

SAMPLOI9 

21 


AIF 

(T'ETO EQ »F*).MOVE 

S AMPL 020 

22 


AGO 

.ERR0R3 

SAMPL021 

23 

•TYPEDEH AN0P 


SAMPL022 

24 

« * 



SAMPL023 

25 

.* 

ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL 

SAMPL024 

26 

# * 



SAMPl025 

27 

ETYPE 

SETC 

T'ETO 

SAMPL026 

28 

.MOVE 

ANOP 


SAMpl02 1 

29 

ft 

NEXT 

TWO STATEMENTS GENERATED FOR MOVE MACRO 

SAMPL02H 

30 


LETYPE 2»6FR0M 

SAKPL024 

31 


STETYPE 2•ETO 

SAMPL030 

32 


MEXIT 


SAMPL031 

33 

• * 



SAMPL032 

34 

• * 

CHECK 

LENGTH ATTRIBUTES OF OPERANDS 

SAMPL033 

35 

• * 



S AMPL 0 34 

36 

TYPECGK 

AIF 

(L’ETO NE L'EFROM OR L'ETO GT 2561.ERR0R4 

SAMPLO }3 

37 

ft 

NEXT STATEMENT GENERATED FOR MOVE MACRO 

SAMPL036 

38 


MVC 

ETO,EFROM 

SAMPL037 

39 


MEXIT 


SAMPL03B 

40 

• * 



SAMPL 034 

41 

* * 

ERROR 

MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS 

SAMPL040 

42 

# ft 



SAMPL041 

43 

.ERR0R1 

MN0TE 

1,'IMPROPER NUMBER OF OPERANDS, NO STATEMENTS GENERATED' 

SAMPL042 

44 


MEXIT 


SAMPL043 

45 

.ERR0R2 

MNOTE 

1,'OPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED' 

SAMPL044 

46 


MEXIT 


S AMPL 04 5 

47 

. ERR0R3 

MNOTE 

1,'IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED' 

SAM.PL046 

48 


MEXIT 


SAMPL047 

49 

•ERR0R4 

MNOTE 

1,'IMPROPER OPERAND LENGTHS, NU STATEMENTS GENERATED' 

SAMPL 04b 

50 


MEN0 


SAMPL049 


The column contains the address of the 
symbol (hexadecimal notation) for SD 
and LD type entries, and zeros for ER 
and WX type entries. For PC and CM 
type entries, it indicates the 
beginning address of the control 
section. 


This column contains the assembled 
length, in bytes, of the control 
section (hexadecimal notation) . 


This column contains, for LD type 
entries, the identification (ID) 
number assigned to the ESD entry that 
identifies the control section in 
which the symbol was defined. 


SOURCE AND OBJECT PROGRAM 


This section of the listing documents the 
source statements and the resulting object 
program. 


This is the deck identification. It 
is the symbol that appears in the name 
field of the first TITLE statement. 


This is the information taken from the 
operand field of a TITLE statement. 


Listing page number. 

This column contains the assembled 
address (hexadecimal notation) of the 
object code. 


162 







© 


® 








© 

EXAM 


SAMPLE 

PROGRAM 







PAGE 2 

© 

( 

s> 

© 

© 


© 


© 

© 

IOC 

08JECT CODE 

ADDR1 

ADDR2 

STMT 

SOURCE 

STATEMENT 

DOS CL3-0 

09/16/67 






52 


t«l 




SAMPL050 






53 

• 


MAIN 

ROUTINE 

• 

SAMPL051 






54 


hft« 




SAMPL052 

000000 





55 



CSECT 



SAMPL053 






56 



ENTRY 

SEARCH 


SAMPL054 

000000 

05C0 




57 

BEGIN 


BALR 

R12.0 

ESTABLISH ADDRESSABILITY OF PROGRAM 

SAMPL05B 

000002 





58 



USING 

*,R12 

AND TELL THE ASSEMBLER 

SAMPL056 

000002 

9857 

C1A6 


001A8 

59 



LM 

R5,R7,=A<LISTAREA,16,LISTEND) LOAD LIST AREA PARAMS 

SAMPL057 

000000 





60 



USING 

LIST »R5 

REGISTER 5 POINTS TO THE LIST 

SAMPL058 

000006 

45E0 

C024 


00026 

61 

MORE 


BAL 

R14,SEARCH 

FIND LIST ENTRY IN TABLE 

SAMPL059 

00000A 

9180 

C022 

00024 


62 



TM 

SWITCH.N0NE 

CHECK TO SEE IF NAME WAS FOUND 

SAMPL060 

000006 

4710 

C018 


0001A 

63 



80 

N0TTHERE 

BRANCH IF NOT 

SAMPL061 

000000 





64 



USING 

TABLE,R1 

REGISTER 1 NOW POINTS TO TABLE ENTRY 

SAM. PL 062 






65 



MOVE 

TSWITCH.LSWITCH 

MOVE FUNCTIONS 

SAMPL063 



■ ERROR 

«t» 














66 




1,IMPROPER OPERAND 

TYPES, NO STATEMENTS GENERATED 







67 



M0UE 

TNUMBER,LNUMBER 

FROM LIST ENTRY 



* •« 

y ERROR 

»«« 














68 



MOVE 

TADDRESS.LAODRESS 

TO TABLE ENTRY 

SAMPL069 






69+* 


NEXT 

TWO STATEMENTS GENERATED FOR MOVE MACRO 


000012 

5820 

500C 


ooooc 

70+ 



L 

2.LADDRESS 



000016 

5020 

1004 


00004 

71+ 



ST 

2*TADDRESS 



00001A 

9680 

5008 

00008 


72 

N0TTHERE 

01 

LSWITCH,NONE 

TURN ON SWITCH IN LIST ENTRY 

SAKPLO/5 

00001E 

8756 

C004 


00006 

73 



BXLE 

R5,R6,MQRE 

LOOP THROUGH THE LIST 

SAMPL076 






74 



EOJ 


END OF PROGRAM, USER LIBRARY MACRO 

SAMPL077 






75+* 36ON- 

-CL-453 

EOJ CHANGE LEVEL 

3-0 


000022 

0A0E 




76+ 


SVC 

14 



C00024 





77 

SWITCH 


DS 

X 


SAMPL0T8 

000080 





78 

NONE 


E0U 

X' 80* 


SAMPL079 






79 



1- ***#» 



SAMPL080 






80 

* 


BINARY SEARCH ROUTINE 

* 

SAMPL081 






81 


t«l 




SAMPL032 

000025 

00 











000026 

947F 

C022 

00024 


82 

SEARCH 


NI 

SWITCH,255-NONE 

TURN OFF NOT FOUND SWITCH 

SAMPL083 

00002A 

9813 

Cl 82 


001B4 

83 



LM 

R1,R3,=F»128,4,128* 

LOAD TABLE PARAMETERS 

SAMPL0B4 

00002E 

4111 

C046 


00048 

84 



LA 

R1» TABLAREA-161R11 

GET ADDRESS OF MIDDLE ENTRY 

SAMPL085 

000032 

8830 

0001 


00001 

85 

LOOP 


SRL 

R3, 1 

DIVIDE INCREMENT BY 2 

SAMPL086 

000036 

D507 

5000 1008 00000 

00008 

86 



CLC 

LNAME,TNAME 

COMPARE LIST ENTRY WITH TABLE ENTRY 

SAMPL087 

00003C 

4720 

C04A 


0004C 

87 



BH 

HIGHER 

BRANCH IF SHOULD BE HIGHER IN TABLE 

SAMPL088 

000040 

078E 




88 



BCR 

8»R 14 

EXIT IF FOUND 

SAMPL039 






89 



SR 

R1.R3 

OTHERWISE IT IS LOWER IN THE TABLE 

XSAMPL090 

000042 

1813 









SO SUBTRACT INCREMENT 

SAMPL091 

000044 

4620 

C030 


00032 

90 

MORE 


BCT 

R2, LOOP 

LOOP 4 TIMES 

SAMPL092 


»** ERROR 

• ** 









000048 

47F0 

C050 


00052 

91 



B 

NOTFOUND 

ARGUMENT IS NOT IN THE TABLE 

SAMPL093 

00004C 

1A13 




92 

HIGHER 


AR 

R1»R3 

ADD INCREMENT 

SAMPL094 

00004E 

4620 

C030 


00032 

93 



BCT 

R2, LOOP 

LOOP 4 TIMES 

SAMPL095 

000052 

9680 

C022 

00024 


94 

N0TF0UND 

01 

SWITCH,NONE 

TURN ON NOT FOUND SWITCH 

SAMPL096 

000056 

07FE 




95 



BR 

R14 

EXIT 

SAMPL097 


This column contains the object code 
produced by the source statement. The 
entries are always left-justified. 

The notation is hexadecimal. Entries 
are machine instructions or assembled 
constants. Machine instructions are 
printed in full with a blank inserted 
after every four digits (two bytes). 
Constants may be only partially 
printed (see the PRINT assembler 
instruction in "Assembler Instruction 
Statements") . 


These two columns contain effective 
addresses (the result of adding 
together a base register value and 
displacement value) : 


1. The column headed ADDR1 contains 
the effective address for the 
first operand of an SS or an SI 
instruction. 


2. The column headed ADDR2 contains 
the effective address of the 
second operand of any instruction 
referencing storage. 


Both address fields contain six 
digits; however, if the high order 
digit is a zero, it is not printed. 
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© 

© 





® 

EXAM 

SAMPLE program 





PAGE 3 

© 

© © 

© 


© 


© © 

LOC 

OBJECT CODE ADDR1 A0DR2 

STMT 

SOURCE 

STATEMENT 

DOS CL3-0 09/16/61 



97 

• 



Q7) 

SAMPL099 



98 

• 

THIS 

IS THE TABLE 

SAMPL100 



99 

• 



SAMPL101 

000058 


100 


DS 

OD 

SAMPL102 

000058 

0000000000000000 

101 

TABLAREA 

OC 

XL 8 *0• 

SAMPL103 

000060 

C1D3D7C8C1404040 

102 


DC 

CL 8 'ALPHA• 

SAMPL104 

GGGGoo 

GGGGGGGCG0GGGG0G 

iG3 


DC 

XL 3 ' G ’ 

5AMkL lOo 

000070 

C2C5E3C140404040 

104 


DC 

CL8 ’BETA * 

SAMPL106 

000078 

0000000000000000 

105 


OC 

XL8 *0* 

SAMPL107 

000080 

C4C5D3E3C1404040 

106 


DC 

CL8'DELTA* 

SAMPL108 

000088 

0000000000000000 

107 


DC 

XL8 *0' 

SAMPL109 

000090 

C5D7E2C9D3D6D540 

108 


DC 

CL8'EPSIL0N' 

SAMPL110 

000098 

0000000000000000 

109 


OC 

XL8•0• 

SAMPL 111 

0000A0 

C5E3C14040404040 

110 


DC 

CL 8 ' ETA • 

SAMPL112 

OOOOA8 

0000000000000000 

111 


0C 

XL 8'O' 

SAMPL 113 

C000B0 

C7C1D4D4C1404040 

112 


DC 

CL8*GAMMA* 

SAMPL114 

0000B8 

0000000000000000 

113 


DC 

XL 8 *0' 

SAMPL115 

ooooco 

C906E 3C140404040 

114 


DC 

CL8*IOTA* 

SAMPL116 

OOOOC8 

0000000000000000 

115 


DC 

XL 8 * 0' 

SAMPL 11? 

000000 

D2CID7D7C1404040 

116 


DC 

CL 8'KAPPA' 

SAMPL 118 

0000D8 

0000000000000000 

117 


DC 

XL 8'0' 

SAMPL 119 

C000E0 

D3C1D4C2C4C14040 

118 


DC 

CLS'LAMBDA' 

SAMPL120 

0000E8 

0000000000000000 

119 


DC 

XL 8'0 • 

SAMPL121 

0000E0 

D4E4404040404040 

120 


DC 

CL 8'MU' 

SAMPL122 

0000F8 

0000000000000000 

121 


DC 

XL 8'0• 

SAMPL123 

000100 

05b4404040404040 

122 


DC 

CLS'NU' 

SAMPL124 

000108 

0000000000000000 

123 


DC 

XL 8'0' 

SAMPL125 

000110 

D604C9C3D9D6D540 

124 


DC 

CL8'OMICRON » 

SAMPL126 

000118 

E040404040404040 

125 


DC 

CL8'0' 

SAMPL12 7 

000120 

07C8C94040404040 

126 


DC 

CL8'PHI * 

SAMPL126 

C00128 

0000000000000000 

127 


DC 

XL 8•0' 

SAMPL129 

000130 

E2C9C7D4C1404040 

128 


DC 

CL8'SIGMA' 

SAMPL130 

COO 138 

0000000000000000 

129 


DC 

XL 8'0' 

SAMPL131 

000140 

E9C5E3C140404040 

130 


OC 

CL 8'ZE TA • 

SAMPL132 



131 

* 



SAMPL133 



132 

• 

THIS 

IS THE LIST 

SAMPL134 



133 

* 



SAMPL!35 

000148 

03C104C2C4C14040 

134 

LISTAREA 

DC 

CL8'LAMBDA• 

SAMPL l 36 

000150 

0A 

135 


OC 

X • OA • 

SAMPL137 

000151 

00001D 

136 


DC 

FL3'29' 

SAMPL138 

000154 

00000000 

137 


DC 

A(BEGIN) 

SAMPL139 

000158 

E9C5E 3C140404040 

138 


DC 

CL8'ZETA' 

SAMPL140 

000160 

05 

139 


OC 

X' 05' 

SAMPL 141 

000161 

000005 

140 


DC 

FL 3'5• 

SAMPL142 

000164 

00000032 

141 


DC 

A(LOOP) 

SAMPL143 

000168 

E3C8C5E3C1404040 

142 


DC 

CL8 'THETA * 

SAMPL144 

000170 

02 

143 


DC 

X '02* 

SAMPL145 

000171 

00002D 

144 


DC 

FL 3 *45 * 

SAMPL146 

000174 

00000000 

145 


DC 

A(BEGIN) 

SAMPL147 

000178 

E3C1E44040404040 

146 


DC 

CL 8•TAU' 

SAMPL148 

000180 

00 

147 


DC 

X'OO' 

SAMPL149 


* 3 This column contains the statement 

number. A plus sign (+) to the right 
of the number indicates that the 
statement was generated as the result 
of macro instruction processing. The 
maximum statement number is 65,535. 

If there are more than 65,535 
statements, the statement number 
wraps-around. 

14 This column contains the source 

program statement. The following 
items apply to this section of the 
listing: 

a. Source statements are listed, 

including those brought into the 
program by the COPY assembler 


instruction, and macro 
definitions submitted with the 
main program for assembly. 
Listing control instructions are 
not printed, except for the 
following case: PRINT is listed 
when PRINT ON is in effect and a 
PRINT statement is encountered. 


b. Macro definitions for system 
macro instructions are not 
listed. 

c. The statements generated as the 
result of a macro instruction 
follow the macro instruction in 
the listing. 
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© 

EXAM 

® 

LOC 

000181 

000184 

000188 

000190 

000190 
000193 
000194 
000198 
0001AO 
0001AI 
0001A4 


000001 

000002 

000003 

000005 

000006 

000007 

OOOOOC 

OOOOOE 


COOOOO 

000000 

000008 

000009 

OOOOOC 


000000 

COOOOO 

000003 

000004 

C00008 

COOOOO 

0001A8 

0001B4 


d 


e 


f 


© 





© 

SAMPLE PROGRAM 





PAGE 4 

© © 

© 

© 


© © 

OBJECT CODE A00R1 AD0R2 

STMT 

SOURCE 

STATEMENT 

DUS CL3-0 09/16/67 

000000 

148 


DC 

FL 3 1 0' 

SAMPLING 

00000001 

149 


0C 

At 1 > 

SAKPL151 

D3C9E2E340404040 

150 


0C 

CL 8 *LI ST' 

SAMPL152 


151 


DC 

X» 1G' 

SAMPL153 

#** ERROR *** 






0001C8 

152 


DC 

FL 3*456• 

SAMPL154 

00 






00000000 

153 


DC 

A ( 0) 

SAMPL155 

C1D307C8C1404040 

154 

LISTEN0 

OC 

CL8'ALPHA' 

SAMPL156 

00 

155 


DC 

X'00' 

SAMPL157 

000001 

156 


DC 

FL 3•1 * 

SAMPL158 

0000007B 

157 


OC 

At 123) 

SAMPL159 


158 

• 



SAMPL160 


159 

• 

THESE 

ARE THE SYMBOLIC REGISTERS 

SAMPL161 


160 

• 



SAMPL162 


161 

R1 

EQU 

1 

SAMPL163 


162 

R2 

EQU 

2 

SAMPL164 


163 

R3 

EQU 

3 

SAMPL165 


164 

R5 

EQU 

5 

SAMPL 16t> 


165 

R6 

EQU 

6 

SAMPL16/ 


166 

R 7 

EQU 

7 

SAMPL168 


167 

R12 

EQU 

12 

SAMPL169 


168 

R14 

EQU 

14 

SAMPLl70 


169 

• 



SAMPL 171 


170 

• 

THIS 

IS THE FORMAT DEFINITION OF LIST ENTRIES 

SAMPL1/2 


171 

• 



SAMPL1 73 


172 

LIST 

DSECT 


SAMPL174 


173 

LNAME 

OS 

CL 8 

SAMPL175 


174 

LSWITCH 

OS 

C 

SAMPL176 


175 

LNUMBER 

DS 

FL3 

S AMPL 177 


176 

LA00RESS 

DS 

F 

SAMPL173 


177 

• 



SAMPL179 


178. 

• 

THIS 

IS FORMAT DEFINITION OF TABLE ENTRIES 

SAMPL180 


179 

• 



SAMPL 181 


180 

TABLE 

DSECT 


SAMPL182 


181 

TNUMBER 

DS 

EL3 

SAMPL183 


182 

TSWITCH 

DS 

C 

SAMPL184 


183 

TA00RESS 

DS 

F 

SAMPL185 


184 

TNAME 

OS 

CL8 

SAKPL186 


185 


END 

BEGIN 

SAMPL187 

0000014800000010 

186 



=AtLISTAREA,16.LISTEND) 


0000008000000004 

187 



=F'128,4,128' 



. Assembler or machine instructions 
in the source program that 
contain variable symbols are 
listed twice: as they appear in 
the source input, and with values 
substituted for the variable 
symbols. 

. Diagnostic messages are not 
listed inline in the source and 
object program section. An error 
indicator, ***ERROR***, appears 
following the statement in error. 
The message appears in the 
diagnostic section of the 
listing. 

. MNOTE messages are listed inline 
in the source and object program 
section. An MNOTE indicator 
appears in the diagnostic section 
of the listing. The MNOTE 
message format is: severity 
code, message text. 

. The MNOTE * form of the MNOTE 
statement results in an inline 


message only. An MNOTE indicator 
does not appear in the diagnostic 
section of the listing. 

h. When an error is found in a 
programmer macro definition, it 
is treated like any other 
assembly error: the error 
indication appears after the 
statement in error, and a 
diagnostic is placed in the list 
of diagnostics. However, when an 
error is encountered during the 
expansion of a macro instruction 
(system or programmer defined), 
the error indication appears in 
place of the erroneous statement, 
which is not listed. The error 
indication appears following the 
last statement listed before the 
erroneous statement was 
encountered, and the associated 
diagnostic message is placed in 
the list of diagnostics, 

i. Literals will appear in the 
listing following an LTORG or the 
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END statement or both. Literals 
are identified by the equals (=) 
sign preceding them. 

j. If the END statement contains an 
operand, the transfer address 
appears in the location column 
(LOC) . 

k. In the case of COM, CSECT, and 
DSECT statements, the location 
field contains the beginning 
address of these control sections 
i.e. , the first occurrence. 

l. For a USING statement, the 
location field contains the value 
of the first operand. 

m. For LTORG and ORG statements, the 
location field contains the 
location assigned to the literal 
pool or the value of the ORG 
operand. 

n. For an EQU statement the location 
field contains the value 
assigned. 

o. Generated statements always print 
in normal statement format. 
Because of this, it is possible 
for a generated statement to 
occupy two or more continuation 
lines on the listing. This is 
unlike source statements which 
are restricted to one 
continuation line. 


«» This field indicates the assembler 
level and version number, e.g., DOS 
CL2-1 reads as DOS assembler level 2, 
version 1. 

Current date obtained from SET card. 

17 Identification-sequence field from the 
source statement. 


RELOCATION DICTIONARY 

This section of the listing contains the 
relocation dictionary information passed to 
the linkage editor in the object module. 

The entries describe the address constants 
in the assembled program that are affected 
by relocation. 


This column contains the external 
symbol dictionary ID number assigned 
to the ESD entry that describes the 
control section in which the address 
constant is used as an operand. 


This column contains the external 
symbol dictionary ID number assigned 
to the ESD entry that describes the 
control section in which the 
referenced symbol is defined. 
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20 


The two-digit hexadecimal number in 
this column is interpreted as follows: 

First Digit—a zero indicates that the 
entry describes an A-type, a Y-type, 
or a COW address constant; 

Second Digit—the first three bits of 
this digit indicate the length and 
sign of the address constant as 
follows: 


Bits 0 and 1 Bit 2 
00 = 1 byte 0 = * 
01=2 bytes 1 = - 

10 = 3 bytes 

11 = 4 bytes 


This column contains the assembled 
address of the field where the address 
constant is stored. 
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CROSS-REFERENCE 

PAGE 1 


@ 

© 



© 



SYMBOL 

LEN 

VALUE 

0EFN 





BEGIN 

00002 

000000 

00057 

0137 

0145 

0185 


HIGHER 

00002 

00004C 

00092 

0087 




LADDRESS 

00004 

oooooc 

00176 

0070 




LIST 

00001 

000000 

00172 

0060 




LISTAREA 

00008 

000148 

00134 

0059 

0186 



listeno 

00008 

000198 

00154 

0059 

0186 



LNAME 

00008 

000000 

00173 

0086 




IMHMRPP 

0000? 

00Q009 

001 75 





LOOP 

00004 

000032 

00085 

0090 

0093 

0141 


LSWITCH 

00001 

000008 

00174 

0072 




MORE 

00004 

000006 

00061 

0073 




MORE 

00004 

000006 

00090 





NONE 

00001 

000080 

00078 

0062 

0072 

0082 0094 


NOTFOUNO 

00004 

000052 

00094 

0091 




NOTTHERE 

00004 

00001A 

00072 

0063 




Rl 

00001 

000001 

00161 

0064 

0083 

0084 0084 0089 0092 


R12 

00001 

OOOOOC 

00167 

0057 

0058 



KIH 

UUUUl 

GGGGGt 

uGioo 

UUOl 

0065 

0095 


R2 

00001 

000002 

00162 

0090 

0093 



R 3 

00001 

000003 

00163 

0083 

0085 

0089 0092 


R5 

00001 

000005 

00164 

0059 

0060 

0073 


R 6 

00001 

000006 

00165 

0073 




R 7 

00001 

000007 

00166 

0059 




SEARCH 

00004 

000026 

00082 

0056 

0061 



SWITCH 

00001 

000024 

00077 

0062 

0082 

0094 


TABLAREA 

00008 

000058 

00101 

0084 




TABLE 

00001 

000000 

00180 

0064 




TADORESS 

00004 

000004 

00183 

0071 




TNAME 

00008 

000008 

00184 

0086 




TNUMBER 

00003 

000000 

00181 





TSWITCH 

00001 

000003 

00182 






CROSS-REFERENCE 


This section of the listing information 
concerns symbols—where they are defined 
and used in the program. 


This column contains the symbols. 


This column states the length (decimal 
notation), in bytes, of the field 
occupied by the symbol value. 


This column contains either the 
address the symbol represents, or a 
value to which the symbol is equated. 


This column contains the statement 
number of the statement in which the 
symbol was defined. 


This column contains the statement 
numbers of statements in which the 
symbol appears as an operand. 


The following notes apply to the 
cross-referencing section: 


• Symbols appearing in V-type address 
constants do not appear in the 
cross-reference listing. 


• A PRINT OFF listing control 

instruction does not affect the 
production of the cross-reference 
section of the listing. 


Undefined symbols appear in the 
cross-reference section. However, 
only the symbol column and the 
reference column have entries. 
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EXAM 

(27) 

@ 



STMT 

ERROR CODE 

MESSAGE 


36 

IJQ073 

ILLEGAL NAME FIELD 


65 

IJQ059 

UNDEFINED SEQUENCE 

SYM80L 

66 

IJQ037 

MNOTE STATEMENT 


67 

IJQ088 

undefined OPERATION 

CODE 

90 

I JQ023 

PREVIOUSLY DEFINED 

NAME 

151 

I J0039 

INVALID DELIMITER 



DIAGNOSTICS 


6 STATEMENTS FLAGGED IN THIS ASSEMBLY 


DIAGNOSTICS 


This section contains the diagnostic 
messages issued as a result of error 
conditions encountered in the program. 
Explanatory notes for each message are 
contained in Appendix N. 


This column contains the number of the 
statement in error. 


This column contains the message 
identifier. 


This column contains the message. 


The following notes apply to the 
diagnostics section: 


• An MNOTE indicator of the form MNOTE 
STATEMENT appears in the diagnostic 
section, if an MNOTE statement is 
issued by a macro instruction. The 
MNOTE statement itself is inline in 
the source and object program section 
of the listing. 


• A message identifier consists of six 
characters and is of the form: 


IJQxxx 


IJYxxx 


IJQ 

identifies the issuing agent as 
DOS/TOS D assembler. 


IJY 

identifies the issuing agent as 
DOS F assembler. 


XXX 

is a unique number assigned to the 
message. 


Two statistical messages may appear in 
the listing. They are: 


1. A message indicating the total 

number of statements in error. If 
no statements are in error, the 
message 


NO STATEMENTS FLAGGED IN THIS 
ASSEMBLY 


is printed following the 
Cross-Reference section and no 
diagnostic section is printed. 


2. A message if one or more Y-type 
address constants appear in the 
program. 


AT LEAST ONE RELOCATABLE Y-TYPE 
CONSTANT IN ASSEMBLY. 


This message if issued, appears 
before the diagnostic section. 
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Appendix J. Assembler Language-Features Comparison Chart 


Features not shown below are common to all assemblers. In the chart: 

Dash ~ Mot allowed. 

X = As defined in IBM Operating System/360 Assembler Language , GC28-6514. 
Op (s) = Operand (s) . 


T 7090/7094 T 

Support 


T-1 

OS/360 
Assembler 


Model 20 

BaSIC 

Assembler 


I _ 


BPS/360: 


Assembler 


Assembler 


BPS 8K Tape 

I nrvn n rr rvi _ 1_ 

j DUO 01\ UJL&K 

Assemblers 


DOS,TOS 
D Assem¬ 
blers 


LA/O r 

Assembler 


H 


No. of Continuation 
Cards/Statement 
(exclusive of macro 
instructions) 


Input Character 
Code 


EBCDIC 


EBCDIC 


BCD 

EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


ELEMENTS: 


Maximum Characters 
per symbol 


Character 

self-defining terms 


1 Char only 


1 Char only 


Binary self-defining 
terms 


Length attribute 
reference 


H 

I 

H 

I 

H 

I 

I 

H 


Literals 


X 

4— 

X 


Extended mnemonics 


X 

224-1 


Maximum location 
counter value 


2 14 - 1 


2«e-1 


224-1 


224-1 


2 24-1 


Multiple Control 
Sections per 
assembly 


EXPRESSIONS: 


Operators 


+ - 
3 


+-* 


+-*/ 


♦-*/ 


+-♦/ 


♦-*/ 


Number of terms 


16 


16 


16 


4— 


Levels of 
parentheses 


4- 

x 


H 


Complex 

relocatability 


.x-i 

(Part 1 of 3) 
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r -|-r-T-T-T-T-1 

1 | | |7090/7094| | | OS/360 | 

j (Model 20 jBPS/360: (Support (BPS 8K Tape(DOS,TOS j Assembler j 

(Feature (Basic jBasic (Package (BOS 8K DiskJD Assem-j DOS F j 

| (Assembler (Assembler (Assembler(Assemblers (biers j Assembler | 

4-4-4-+-4-4-4--I 

(PRINT j- |- j-- (X jX (X | 

j.-(-f- 4 -4-4-4- \ 

(TITLE j- (- (X (X |X (X | 

J.-4-4-4-4-4- 4 -1 

(COM !- - !- - !- - !— |X ! x ! 

j.- 4 -4--4-4-4-4-"I 

(ICTL j— ( 1 op (1 or I 1 op (X (X (X ( 

I | ( 25 only) ( | I I I 

j.-^-4-4- 4 - 4 - 4 -•—-j 

j USING j 2 ops (op 1 j 2 ops (op 1(2-17 (ops J 6 ops j X (X j 

j jrelocatable!relocatablejrelocat- j j j j 

I I Innlirt UKU I II I 

• I I —**j; I II I 

I ! I | only) | I I I 

j.- j - 4 -4-4-4-4-^ 

(DROP j 1 op only j 1 op only (X (5 ops (X (X j 

4-4-4-4-4-4-4-1 

(CCW I-- (op 2 (relo-jx |X jx j X j 

J f |eatable | ( I I I 

i I | only) | J I I I 

J.-4-4-4-4-4-4-1 

jORG (no blank opjno blank op(no blank JX (X j X | 

I I I lop ( | | | 

4-4-4-4-4-4-4-1 

(ENTRY (1 op only |1 op only (1 op only|1 op only (X (X J 

y - \ -4-4-4-4-4-1 

|EXTRN |1 op only |1 op only |1 op onlyjl op only (X (X j 

| | | (max 14) | | || | 

4-4-4-4-4-4-4-^ 

|WXTRN j-- j— j— j— |DOS 14K j — j 

I I I I I ID only | | 

j._.j__|___ 4 ___ 4 _ j. _ 4 _ I 

|CNOP (-- |2 decimal |2 decimal!2 decimal |X | X f 

I j jdigits jdigits jdigits j j j 

4-4-4-4-4-4-4-< 

j PUNCH J-- |— j— |X |X j X | 

4-4-4-4-4-4-4- i 

(REPRO j-- |— j— IX IX j X j 

y - \ -4-4-4-4-4--j 

j Macro j S/360 j— j— jx jx j X j 

jInstructions jModel 20 j j j j j j 

| (IOCS only | || || | 

L-X_J.-X-X- J _X-J 

(Part 3 of 3) 
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Macro Facility Features 


BPS 8K Tape, 
BOS 8K Disk 
Assemblers 


DOS, TOS 
Assemblers 


OS/360 
Assembler 


Operand Sublists 

Attributes of macro instruction operands inside macro 
definitions and symbols used in conditional assembly 
instructions outside macro definitions. 

Subscripted SET symbols 

Maximum number of operands 

Conditional assembly instructions outside macro 
definitions 

Maximum number of SET symbols 
global SETA 
global SETB 
global SETC 
local SETA 
local SETB 
local SETC 


1 Maximum number of operands in DOS assembler F is 200. 

+ The number of SET symbols permitted by the Disk and Tape Operating Systems Assemblers 
and the IBM System/360 Operating System Assembler is variable, dependent upon the 
available main storage. 

Note : The maximum size of a character expression is 127 in DOS (assembler D) and TOS 
and 255 characters in OS and DOS (assembler F) . 
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Appendix K. Card Input for Assembly Runs 


Figure 22 lists the control cards necessary to assemble a program. The card groups are 
listed in the order in which they must appear. All job control cards enter the system 
via SYSRDR, all others via SYSIPT. The same device may be assigned for both SYSRDR and 
SYSIPT. If this device is a disk file, the combined file must be designated as SYSIN. 
Job control statements are described in the publications IBM System/360 Disk Operating 

System : System Control and System Service Programs or IBM System/360 Tape Operating 

System: System Control and System Service Programs . 


r - 1 - 

|Card Group |Card Arrangement 


j Comments 



ASSGN SYSCLB 

// ASSGN SYSSLB, 

// ASSGN SYSIPT, 
// ASSGN SYSLST, 


// ASSGN SYSOO1,. 
// ASSGN SYS002,, 
// ASSGN SYSOO3,. 

// ASSGN SYSPCH,, 

// ASSGN SYSLNK,, 

// OPTION DECK,.. 

!// EXEC ASSEMBLY 


First card in group, always required. 

Used when the core image library is on a separate 
(private) file (see Note 3) . 

Used when the source statement library is on a 
separate (private) file. 1 

Source program input. 

Program listing. 


Work files. 

Required when DECK option is specified. 

Required when assemble-and-execute is specified. 

Optional. Used to indicate desired assembler 
functions. 

Required. 


(Assembler 
jInput 


Source Deck 


I/* 


Source statements (machine, 
assembler, and macro instructions) 

Indicates end-of-data set. 


h--I-f ■ 

(Job Control j/S j 

j.---J- L - 

J 1 SYSSLB is assigned as follows: 

I 

| For DOS—SYSSLB cannot be assigned for the 10K assembler. If SYSSLB is assigned for 

j the 14K D assembler or the F assembler, it is concatenated with the source statement 

| library on SYSRES. (The assembler searches first SYSSLB and then the SYSRES 

j library.) The 10K D assembler and if SYSSLB is not assigned the 14K D and F 

j assemblers use only the source statement library of SYSRES. 

» 

t 

I For TOS—Both TOS assembler variants use either SYSSLB or the source statement 
j library on SYSRES. They use SYSSLB if it is assigned. If it is not assigned, they 
j use the SYSRES library. 


End-of-job statement. 


Figure 22. Card Input for an Assembly (Part 1 of 2) 














Note 1 : Only those assignments and options not already in effect are required. 

Note.2 : Assignments for SYSIN and/or SYSOUT must be accomplished by permanent 
assignments. For details see the publications for DOS and TOS system control and 
system service programs. 

Note 3 : Normally the assembler and the linkage editor can be executed in the 
background only. However, in a Disk Operating System that supports the batched-job 
foreground and private core image library options, the assembler and the linkage editor 
can also be executed in any of the foreground partitions provided that the partition is 
2K bytes larger than the minimum main storage area required by the assembler; then the 
appropriate private core image library must be assigned instead of the library on the 
system residence device (SYSRES) . A private core image library must be assigned with a 
job control command (a job control command differs from a job control statement in that 
it does not have slashes in columns 1 and 2) , which makes it a permanent assignment. 

It remains in effect until another ASSGN command for SYSCLB is encountered. 


Figure 22. Card Input for an Assembly (Part 2 of 21 
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|Symbolic UnitJRemarks 

F-f- 


j Function and Device 
- + - 


SYSRDR 


Required if the SYSIN 
option is not used. 


Job control statement input device. May be the 
same device as SYSIPT except for combined input 
from IBM 2311, 2314, or 2319 Disk Extent (see 
SYSIN) . 


IBM 1442, 2520, or 2540 Card Read Punch, IBM 2501 
Card Reader 9 IBM 24GG~Serxe5 KayliecxC Tape Unit 9 
or IBM 2311, 2314 or 2319 Disk Extent for the 
disk system. 


SYSIPT 


Required if the SYSIN 
option is not used. 


Source program input device. May be the same 
device as SYSRDR except for combined input from 
IBM 2311, 2314, or 2319 Disk Extent (see SYSIN). 

IBM 1442, 2520, or 2540 Card Read Punch, IBM 2501 
Card Reader, IBM 2400-series Magnetic Tape Unit 
(7-or 9-track), or IEM 2311, 2314, or 2319 Disk 
Extent for the disk system. If the Data 
Conversion feature was used to prepare the 
7-track tape, it must also be used to read the 
tape. The tape or disk records must be 80-byte 
unblocked records. 


SYSIN 


Required for combined 
disk input. 

Optional for combined 
card or tape input. 


Used for a combined input file for SYSRDR 
and SYSIPT. 

IBM 1442, 2520, or 2540 Card Read Punch, IBM 2501 
Card Reader, IBM 2400-series Magnetic Tape Unit, 
or IBM 2311, 2314, or 2319 Disk Extent for the 
disk system. 

SYSIN can be used in lieu of the SYSDR and SYSIPT 
designation when the file is card or tape input. 
It must be used when the file is disk input (disk 
system only) . 


SYSLST 


Required if the SYSOUT 
option is not used. 


Program listing device, 


IBM 1403, 1404 (continuous forms only), or 1443 
Printer. IBM 2400-series Magnetic Tape Unit 
(9-track, or 7-track with or without the Data 
Conversion feature) or IEM 2311, 2314, or 2319 
Disk Extent for the disk system. 

Listing on tape or disk appears as 121-character 
print images (a single forms control followed by 
a 120-character line image). 


SYSPCH 


Optional. 


Object program output device. 

IBM 1442, 2520, or 2540 Card Read Punch. IEM 
2400-series Magnetic Tape Unit (9-track, or 
7-track with the Data Conversion feature), or IEM 
2311, 2314, or 2319 Disk Extent for the system. 

Output on tape or disk is in 81-byte unblocked 
records. 

Not used when the assemble-and-execute or the 
NODECK option is specified. 


Figure 23. Device Assignments (Part 1 of 2) 


176 












JSymbolic Unit}Remarks 


SYSOOT 


Optional 


^- 

ISYSLNK 


+ - 

j Optional 


SYS001) 
SYS002J 
SYS003J 


+- 

I 

|Required 


f- 

ISYSCLB 


f- 

J Optional 


|-- 

j SYSSLB 


+- 

|Optional 


y 


j Function and Device 

+- 

J Used for a combined output file for SYSLST and 
j SYSPCH to a single tape unit. 


—n 

I 

H 


j IBM 2400-series Magnetic Tape Unit (9-track, or 
j 7-track with the Data Conversion feature). 

4 --- 

J Used for temporary storage of assembler output, 
j Required only when the assemble-and-execute 
( option is specified. 





+ 



IBM 2400-series Magnetic Tape Unit (9-track, or j 
7-track with the Data Conversion feature) for thej 
tape system or IBM 2311, 2314, or 2319 Disk j 

Extent for the disk system. This extent may be j 
on the same device that contains the COS resident! 
system. j 

-4 

Used for temporary work area during assembly. | 

IBM 2400-series Magnetic Tape Unit (9-track, or j 
7-track with the Data Conversion feature) for j 

either the tape or disk systems or three IEM j 

2311, 2314, or 2319 Disk Extents for the disk j 
system. These extents may be on the same device j 
that contains the DOS resident system. j 

For details of work file assignement, see the f 

publication for DOS system generation. | 

--- - - ( 

May be used only on a EOS system that supports { 
the private core image library option. Must be j 

the same device type as SYSRES. See also Note 3 j 
in Figure 22. j 

--4 

Must be same device as SYSRES. See Appendix M, | 
Figure 31. j 

- 4 


jNote: The 2311, 2314, or 2319 can be used for one or more of the symbolic units | 
ISYSRDR, SYSIPT, SYSIN, SYSPCH, or SYSLST only if a supervisor has been SYSGEN'd that j 
jean accommodate input from disk storage or output to disk storage for these units. Forj 
jdetails see the DOS system generation manual. j 

L-1 


Figure 23. Device Assignments (Part 2 of 2) 


r- ^ 

I Input and Output Using an IBM 1442 or 2520 Card Read Punch : Whenever an IEM 1442 or | 
|2520 Card Read Punch is assigned tc SYSRDR , SYSIPT, or SYSIN and also to SYSPCH, a j 

jnumber of blank cards sufficient for punching the output deck must follow the /* card j 
jfollows the assembler END statement in the source deck. This is to prevent erroneously! 
jpunching the cards of a following job step. Any extra cards that are not needed are j 
1 automatically bypassed. j 

L—--J 

Figure 24. Operating Considerations 
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1 


JCard Group 

[ - 

Job Control 


|Card Arrangement 
// JOB ,.. 

// ASSGN SYSRLB.. 


j Comments 

+ - 

First card in group, always required. 

Used by the linkage editor when the relocatable 
library is on a separate (private) file and 
previously assembled modules are to be included. 

Used when the source statement library is on a 


Source program input. 

Program listing. 

Required for assemble-and-execute. 
Work files. 


Required. Used to indicate LINK option and any 
additional assembler functions desired. 


// ASSGN SYSSLB.. 

// ASSGN SYSIPT.. 

// ASSGN SYSLST.. 

// ASSGN SYSIUK. . 

// ASSGN SYSOO1., 
// ASSGN SYS002.. 
// ASSGN SYSOO3.. 

// OPTION LINK... 
// EXEC ASSEMBLY 


-+ 


Required. 


Assembler Input 
Source Deck 


/* 


Source statements (machine, assembler, and 
macro instructions) Note ; If the operand of the 
END statement is omitted, a PHASE card must 
precede the // EXEC ASSEMELY card or an ENTRY 
card must follow the END statement (tape system 
only) . 

Indicates end-of-data set. 


-+ 


Job Control 


ENTRY... 

// EXEC LNKEDT 
// EXEC 


Calls the linkage editor. 


Data 


Data, if any 
/♦ 


End-of-data set indicator. 


- +- 


H 

I 

H 


Job Control 


l/« 


j End-of-job statement. 


« See Figure 22. 


j Note 1 : Only those assignments and options not already in effect are required. | 

I I 

{ Note 2 ; Assignments for SYSIN and/or SYSOUT must be accomplished by permanent f 

jassignments. For details see the publications for DOS and TOS system control and j 

jsystem service programs. j 

i- j 

Figure 25. Card Input for Assent)ly. Linkage Editing, and Execution 
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Note: 

Broken lines indicate 
where the Assembler 
input would be placed 
if SYSIPT were the 
same unit as SYSRDR. 


\ 


/& 


SYSLOG 


See Figure 25. 


(// EXEC ASSEMBLY 

Optional -/"?// ASSGN SYSSLB,... 

*■—/ //_ - 1 


(// ASSGN SYSPCH,!. . 


(//ASSGN SYS003,.. . 


(// ASSG N SYS002, ♦. J U / 


(//ASSGN SYSOO^TT T 
Optional - *{// ASSG N SYSLNK,.. . 

(//ASSGN SYSLST, ...| - 
(//ASSGN SYSIPT,.. 
Optional •—►(// OPTION ~~ 


/ 




( \ 
- j 

< v— 

I SYSIN 

I-— -J (Opti onal) 



SYSOUT 

(Optional) 


-J 

SYSPCH 

(Optional) 


— SYSLNK 
(Optional) 


Figure 26. I/O Units Used by the Tape Assembler 
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Note: 

Broken lines indicate 
where the Assembler 
input weuld be placed 
if SYSI-PT were the 
some unit as SYSRDR. 

If SYSIPT and 
SYSRDR ore the some 
disk unit, they must be a 
combined file assigned 
as SYSIN. 

Optiona 


Optional 

Optiona 


M 


& 




EXEC ASSEMBLY 


// ASSGN SYSSLB 
*^// ASSGN SYSPC H,. ..j 
|// ASSGN SYS003, 
(//ASSGN SYS002,... 

r. .“—i 



SYSSLB 

(Optional) 


J 






/ 

System 


System/360 

X. ’ 


Pack 

^^ 






\ x r "sx x 


SYSLST 



^ / \ ^ 

^_ 

SYS LOG 


Q 




Three 

Disk 

Extents 


SYSLNK 

(Optional) 


SYS003 


See Figure 25. 


SYSCLB 

(Optional) 




/- 

iC_ 


_i 


SYSIN 


(Required if SYSRDR 
and SYSIPT are a 
combined disk file. 
Optional if SYSRDR 
and SYSIPT are a 
combined card or 
tape file.) 


SYSOUT 

(Optional) 


Figure 27. I/O Units Used by the Disk Assembler 
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Assemble-and-execute 


Assemble-and-execute 
(Include object 
routines from the 
relocatable library) 


Assemble-and-execute 
(Include object 
routines from cards) 


Assemble-and-execute 
(Include object 
routines from the 
relocatable library 
and from cards 


j// JOB.. 

• 

1// 

i 

JOB... 


1// 

I 

JOB... 


1// 

i 

JOB.. , 

• 

1 

j// ASSGN 

SYSIPT... 

1// 

ASSGN 

SYSIPT... 

1// 

ASSGN 

SYSIPT... 

1// 

« 

ASSGN 

SYSIPT. 

1 

|// ASSGN 

• 

SYSLST,... 

I 

1// 

i 

ASSGN 

SYSLST,.. . 

I 

1// 

I 

ASSGN 

SYSLST,... 

I 

1// 

1 

ASSGN 

SYSLST, 

1 

|// ASSGN 

SYSOO1,.. 

1// 

ASSGN 

SYSOO1,.. 

1 

)// 

ASSGN 

SYS001,.. 

1 

1// 

ASSGN 

SYSOO1, 

|// ASSGN 

SYS002,.. 

1// 

ASSGN 

SYS002,.. 

1// 

ASSGN 

SYS002,.. 

1// 

ASSGN 

SYS002, 

j// ASSGN 

1 

SYS003,.. 

1// 

ASSGN 

SYS003,.. 

1// 

ASSGN 

SYS003,.. 

1// 

1 

ASSGN 

SYS003, 

j// ASSGN 

1 

SYSLNK,... 

1 

1// 

1 

ASSGN 

SYSLNK,... 

I 

1// 

ASSGN 

SYSLNK,.. 

I 

1// 

ASSGN 

SYSLNK, 

1 

j// OPTION LINK,... 

1 

1 

1// 

OPTION 

[ LINK,.. 

1 

1// 

OPTION 

1 LINK,.. 

1 

1// 

OPTION LINK,. 

j// EXEC ASSEMBLY 

1 

1// 

EXEC ASSEMBLY 

1 

1// 

EXEC ASSEMBLY 

I 

1// 

EXEC ASSEMBLY 


H 


Source Deck 
/* 


Source deck 
/* 


Source deck 

/* 


Source deck 

/* 


INCLUDE SUBR1 
INCLUDE SUBR2 


INCLUDE 
Object deck (s) 

/♦ 


ENTRY .... 
// EXEC LNKEDT 


ENTRY .... 
// EXEC LNKEDT 


ENTRY . 

// EXEC LNKEDT 


INCLUDE SUBR1 
INCLUDE 
Object deck (s) 

/* 

INCLUDE SUBR2 

INCLUDE SUBRT 
ENTRY_ 

// EXEC LNKEDT 


Any job control cards needed for the programs to be executed. 

// EXEC I// EXEC I// EXEC \// EXEC 


H 


Data, if any 

/* 


JData, if any 

I/* 

H- 

I/S 

A _ 


jData, if any 

I/* 

4- 

I/S 

.x_ 


|Data, if any 

I/* 

4 - 

I/s 


H 


F- 


/s 


If SYSRDR and SYSIPT are different units, a/6 card must placed after the last EXEC card 
in SYSRDR, and should be placed after the last /* in SYSIPT. 


Figure 28. Card Input for Different Variations of Assembly, Linkage Editing and 
Execution 
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Appendix L. Replacing the Current Assembler 


The EXEC ASSEMBLY statement causes the job 
control program to look for a phase with 
the name ASSEMBLY in the Core Image Library 
and load it into main storage. Since 

duplicate HautcS CaiinOt appear ill a a.iuITaiTy , 

and every version of the assembler 
processor has the same phase name, only one 
of them can be in the Core Image Library at 
a time. Therefore the variant best suited 
for the particular installation is normally 
included in the Core Image Library. The 
programmer can, however, select another 
variant from the Relocatable Library and 
include it in the Core Image Library 
instead of the variant that is already 
there. 

Figure 29 shows the job control cards 
required to bring a particular assembler 
variant from the Relocatable Library into 
the Core Image Library, and Figure 30 shows 
the valid assembler names (the names under 
which the variants would be cataloged in 
the Relocatable Library). After the 
variant has been included in the Core Image 
Library, it can be loaded and executed 
through the EXEC ASSEMBLY statement. 


j// JOB CONDENSE 
j// EXEC MAINT 
| DELETC ASSE.ALL 
| CONDS CL 

I/S 

|// JOB LINKASM 
j// OPTION CATAL 
| INCLUDE name 1 
j// EXEC LNKEDT 


This job not 
needed in TOS 


1 'name' selected from those listed in 
Figure 30. 


Figure 29. Card Input for Selecting 

Different Assembler Variants 


Variants IJQT16, IJQD16TW, and IJQD16DW 
must be used if the assembler is to be run 
in less than 14K of available core. 
Variants IJQT32 and IJQD32 may be used if 
available core is never less than 14K. 

The IJQ variants are D assemblers. 

Variant IJYASM (the DOS F assembler) may 
be used if available core is never less 
than 45,056 bytes. 

IJQT32 andIJQD32 are generally faster 
than LJQT16 and IJQD16DW or IJQD16TW, 
respectively, because they have test i/o 
buffering and can use the additional core 


to build larger symbol tables. The 
difference in speed varies with the amount 
of additional core and the number of 
symbols in the assembly. 

Thus, if the assembly has few symbols 
or if only a small amount of additional 
core is available to a larger variant, the 
larger and smaller variants will be nearly 
equal in speed. 

For comparable assemblies: DOS 
assembler F (IJYASM) is up to 45X faster 
than DOS assembler D. 


Note 1 : The descriptions 16K and 32K 
refer to the machine size required to run 
the 10K and 14K variants respectively 
(except that the 14K variant can run on a 
IBM System/360 Operating System Model 30 
with 24K of core) . 


Note 2 : Some installations have two or 
more assemblers in the Core Image Library. 
In such instances, the phase names have 


been changed to avoid duplicate names in 
the library. (Refer to IBM System/360 
Disk Operating System: System Generation 
and Maintenance , and IBM System/360 Tape 
Operating System: System Generation and 
Maintenance .) 


r - t- T - T - 1 

(Name |System|Work Files 1 |Minimum Core 2 | 

\ -4-4-4-^ 

jIJQD16DW|D0S j Disk j10,240 j 

III I I 

jIJQD16TW|D0S j Tape 110,240 j 

III I I 

fIJQD32 j DOS jMixed j 14,336 J 


jIJYASM j DOS jMixed j45,056 j 

I-- 4 - 4 -4-4 

jIJQT16 |TOS |Tape |10,240 | 

III I I 

jIJQT32 j TOS |Tape | 14,336 | 

j.-x-j.-x-^ 


j 1 Mixed work files mean any combination j 
j of 2400-series tapes and/or 2311 and/orj 
| 2314 disk extents for SYS001, SYS002, j 

J and SYS003. In general, the assembler j 
j uses SYS001 and SYS002 as serial files j 
j and SYS003 as a random access file. j 

I I 

| 2 Minimum core refers to the minimum | 
j number of contiguous bytes necessary j 
| for the particular assembler variant toj 
j function correctly. | 

L_J 

Figure 30. Assembler Variants 
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Appendix M. Object Deck Output 


Figure 31 lists the card groups that make 
up the output deck produced by the 
assembler. The groups are listed in the 
order in which they appear in the output 
deck. 


Note : No output deck will be produced when 
NODECK appears in the OPTION card. 

The formats of the ESD, TXT, RLD, END, 
and SYM cards are shown in Figures 32 and 
33. 


jCard Group 

^- 

(Reproduced Cards 


Symbol Table (SYM) 

External Symbol Dictionary (ESD) 
Problem Program 


(Relocation Dictionary (RLD) 

i 

(END Card 

}.- 

( Object Deck Identification 


jRemarks 

+-- 

|These reproduced cards result from REPRO or PUNCH 
jinstructions located before START. 

I 

(Produced when SYM appears in the OPTION card. 


Consists of text (TXT) and reproduced cards. The 
reproduced cards result from REPRO or PUNCH 
instructions located after START. 

Produced if relocatable constants are present. 

Produced as the last card of the output deck. 


I 

H 


The 4-character assembly identification label punched into the name entry of the first 
TITLE card in the source program is punched into columns 73-76 of each record in the 
object deck. If there is no label, these columns are left blank. 


Object Deck Sequencing Numbering 


(An assembler-generated sequence number is punched into columns 77-80 of each card in j 
(the object deck. j 

i-1 


Figure 31. 


Assembler Output Deck 
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The information in each card is in Extended Binary Coded Decimal Interchange Code. 


Figure 32. Format of ESD, TXT, RLD, and END Cards 


j Columns j Punched 


73-76 jProgram identification taken from 
jthe name field of the first TITLE 
j statement. 
j 

77-80 {Sequence number. 


RLD Card 


11-12 


17-72 


73-76 


77-80 


Multiple punch (12-2-9). 

p.LD—Relocation Dictionary card. 

Number of bytes of information 
contained in the card. 

Variable information (multiple 
items) . 

•2 positions. Pointer to the 
relocation factor of the 
contents of the load constant. 

•2 positions. Pointer to the 
relocation factor of the 
control sections in which the 
load constants occurs. 

•1 position. Flag indicating 
type of constant. 

•3 positions. Assembled 
address of load constant. 

Program identification taken form 
the name field of the first TITLE 
statement. 

Sequence number. 


END Card 


15-16 


17-22 


73-76 


77-80 


Multiple punch (12-2-9) . 

END 

Assembled origin of the label 
supplied to the Assembler in the 
END card (optional) . 

ESID number of the control 
section to which this END card 
refers. 

Symbolic label supplied to the 
Assembler if this label was not 
defined within the assembly. 
Program identification taken from 
the name field of the first TITLE 
statement. 

Sequence number. 


r- r - 

| Columns J Punched 


ESD Card 


1 |Multiple punch (12-2-9). 

I Identifies this as a loader card. 


ESD—External Symbol Dictionary 
card. 


11-12 


15-16 


17-72 


73-76 


Number of bytes of information 
contained in this card. 

External symbol identification 
number (ESID) of the first SD, 
PC, WX, or ER on this card. 
Relates the SD, PC, WX, or ER to 
a particular control section. 

Variable information. 

•8 positions. Name. 

•1 position. Type code to 
indicate SD, WX, PC, LD, or 
ER. 

•3 positions. Assembled 


•3 positions. 

origin. 

•1 position. 
•3 positions. 


•1 position. Blank. 

•3 positions. Control section 
length, if an SD-type or a 
PC-type. If an LD-type, this 
field contains the external 
symbol identification number 
(ESID) Of the SD or PC 
containing the label. 

Program identification taken form 
the name field of the first TITLE 
statement. 


77-80 jSequence number. 


TXT Card 


11-12 


15-16 


17-72 


{Multiple punch (12-2-9). 
{Identifies this as a loader card. 
{TXT—Text card. 

{Assembled origin (address of 
|first byte to be loaded from this 
J card) . 

|Number of bytes of text to be 
|loaded. 

{External symbol identification 
|number (ESID) of the control 
j section (SD) containing the text. 
JUp to 56 bytes of text—data or 
jinstructions to be loaded. 
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r-r-1 

| Columns|Contents | 

K-+-^ 

j 1 j 12-2-9 punch j 

j 2-4 jSYM I 

| 5-10 jBlank j 

111-12 JNumber of bytes in the Variable Field J 

J13-14 jBlank | 

j 15-16 j ES1D j 

j 17-72 JThe Variable Field (see below) j 

|73-76 (Deck ID (from the first TITLE card) or blank J 

J77-80 jCard sequence number j 

F- A --I 

|The variable field (columns 17-72) contains up to 56 bytes of AUTOTEST text. The itemsj 
jmaking up the text are packed together; consequently the last card may contain less j 
|than 56 bytes of text in the variable field. The contents of the fields within an j 

(individual text item are, as follows: | 

j 1.Organization (1 byte) : J 

j Bit 0:0 j 

j Bit 1: 1 | 

| Bit 2: 1 | 

j Bit 3: 1 j 

j 1 = DC or DS j 

j Bit 4 : j 

j 0 = not DC or DS j 

j Bits 5-7: Length of name minus one. J 

j 2. Address (3 bytes) : displacement from base of control section. j 

| 3. Symbol Name (1-8 bytes): symbolic name of the particular item. j 

JThe following fields are present only for data-type items: J 

j 4. Data Type (1 byte): j 

| X'OO character | 

|X'04* hexadecimal J 

jx'08' binary J 

jx'IO* full word, fixed point j 

JX*14* half word, fixed point j 

jX•18* single precision floating point j 

JX'IC' double precision floating point j 

|X'20' A-type or Q-type address constant J 

JX'24* Y-type address constant j 

jx‘28' S-type address constant j 

|X'2C* V-type address constant j 

JX'30* packed decimal j 

JX , 34' zoned decimal j 

j 5. Length (1-2 bytes): length of data item minus one. Occupies two bytes for j 

j character, hexadecimal and binary items; otherwise one. | 

| 6. Multiplicity (1 byte) : always X'01*. | 


Figure 33. Format of the SYM card. 
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New text can be substituted for 
assembled text using the REP card. Each 
REP card must contain the assembled address 
of the first byte to be replaced and the 
identification of the control section to 
which it refers, and may contain from two 
to 22 bytes of text. The text is 
substituted, byte for byte, for the 
original text, beginning at the address 
specified. The address, the control 
section reference, and the new text must be 
stated in hexadecimal. The REP card must 
be placed after the TXT cards in the object 
module that it modifies. Its format is 
shown in Figure 34. 


Columns 

I Contents 

J. - . . ..... , . .... 

1 

T 

(Multiple punch (12-2-9). 

|Identifies this as a loader card 

1 

2-4 

1 

|REP—Replace text card. 

1 

5-6 

1 

j Blank. 

1 

7-12 

1 

(Assembled address of the first 
jbyte to be replaced 
j (hexadecimal) . Must be right 
(justified with leading zeros if 

jneeded to fill the field. 

1 

13 

1 

|Blank. 

1 

14-16 

jExternal symbol identification 
jnumber (ES1D) of the control 
jsection (SD) containing the text 
j (hexadecimal) . Must be right 
jjustified with leading zeros if 
|needed to fill the field. 

t 

17-70 

1 

|From one to eleven 4-digit 
(hexadecimal fields separated by 
(commas, each replacing two bytes 
j A blank indicates the end of 

(information in this card. 

1 

71-72 

1 

j Blank. 

1 

73-80 

1 

|Kay be used for program 
jidentification. 


Figure 34. Format of the REP card. 


186 






Appendix N. Diagnostic Error Messages 


Diagnostic error messages are printed 
following the cross-reference listing, in 
statement number order. The message code 
has the form IJQnnn for the D assembler and 
IJYnnn for the F assembler. Figure 35 


lists the diagnostic messages and their 
message codes. If errors are encountered 
while editing library macros, the statement 
number referenced will be that of the "END" 
statement. 


r- t 

Message 

Code 


Message 


Meaning 


-j 


IJQ 001 
IJY 


IJQ 

IJY 

IJQ 

I3Y 

IJQ 

IJY 

IJQ 

IJY 

IJQ 

IJY 


IJQ 

IJY 

IJQ 

IJY 

IJQ 

IJY 

IJQ 

IJY 


002 


003 


004 


005 


006 


007 


008 


009 


010 


DUPLICATION FACTOR ERROR 


RELOCATABLE DUPLICATION FACTOR 


LENGTH ERROR 


RELOCATABLE LENGTH 


S-TYPE CONSTANT IN LITERAL 


INVALID ORIGIN 


LOCATION COUNTER ERROR 


INVALID DISPLACEMENT 


MISSING OPERAND 


INVALID SPECIFICATION OF REGISTER 
OR MASK FIELD 


Duplication factor: 

1. Is zero in a literal. 

2. Is not a positive absolute expression. 


Duplication factor is relocatable. 


1. Out of permissable range, 

2. Invalid specification. 

Length is relocatable. 


S-type constant in literal. 


Location counter has been reset to a value 
less than the starting address of the control 
section. 

Location counter has exceeded 2 24 -1. 


Displacement in an explicit address is not 
within 0-4095. 

Operand is missing. 


1. The register or mask field specification 

not an absolute value. 

2. The register or mask field specified not 

in the range 0 - 15. 

3. An odd register specified where an even 
register is required (multiply, divide, 
and shift instructions). 

4. The register specified is not a floating 
point register (floating point 
instructions) . 

5. The register specified is not an 
extended precision floating point 
register (extended precision floating 
point instructions) . 

6. The immediate field specified for an SRP 
instruction not in the range 0-9. 


Figure 35. Assembler Diagnostic Error Messages (Part 1 of 14) 
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Message 

Code 


Message 


Meaning 


IJQ Oil 
IJY 


IJQ 012 
IJY 

IJQ 013 
IJY 

IJQ 014 

IJY 

IJQ 015 
IJY 


IJQ 016 
IJY 


IJQ 017 
IJY 


IJQ 018 
IJY 


IJQ 019 
IJY 


IJQ 020 
IJY 


IJQ 021 
IJY 

IJQ 022 
IJY 


IJQ 023 
IJY 

IJQ 024 
IJY 

IJQ 025 
IJY 


SCALE MODIFIER ERROR 


RELOCATABLE SCALE MODIFIER 


EXPONENT MODIFIER ERROR 


RELOCATABLE EXPONENT MODIFIER 


INVALID LITERAL USAGE 


INVALID NAME 


DATA ITEM TOO LARGE 


INVALID SYMBOL 


EXTERNAL SYMBOL ERROR 


INVALID IMMEDIATE FIELD 


SYMBOL NOT PREVIOUSLY DEFINED 


ESD TABLE OVERFLOW 


PREVIOUSLY DEFINED NAME 


UNDEFINED SYMBOL 


RELOCATABILITY ERROR 


Scale modifier is: 

1. Too large. 

2. Not an absolute expression. 

Scale modifier is not allowed to be 
relocatable. 

Exponent is: 

1. Out of range. 

2. Not specified as an absolute expression. 
Exponent modifier is not allowed to be 
relocatable. 

A valid literal is used illegally, 
e.g., specifies a receiving field or a 
register. 

Name entry incorrectly specified— 

1. Contains more than 8 characters. 

2. Does not begin with a letter. 

3. Has a special character imbedded. 

The constant is too large for: 

1. The data type. 

2. The explicit length. 

The symbol specification is invalid, 
e.g., longer than 8 characters, embedded 
special character. 

1. Identical name entry in a CSECT 
and a DSECT statement. 

2. Identical operands in one or more 
EXTRN/WXTRN statements. 

1. The immediate field is not an absolute 
expression. 

2. The value of the immediate field 
is not in the range 0-255. 

A statement requiring predefined symbols 
contains a symbol not predefined. 

The total number of control sections, dummy 
sections, and unique symbols in EXTRN 
statements and V-type constants exceeds 255. 

The symbol in the name entry has appeared 
in the name entry of a previous statement. 

A symbol being referenced has not been 
defined in the program. 

A relocatable or complex relocatable 
expression is specified where an absolute 
expression is required. 
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Message 


Code j Message 

i_ 

{Meaning 

j. 

IJQ 

IJY 

026*1 TOO MANY LEVELS OF 
j PARENTHESES 

1 

T 

{Expression specifies more than 5 levels 
jof parentheses. 

1 

IJQ 

IJY 

1 

0 27 j TOO MANY TERMS 

1 

1 

I 

{More than 16 terms specified in an 
{expression. 

i 

IJQ 

IJY 

1 

028|REGISTER NOT USED 

1 

1 

1 

{A register specified in a CROP statement 
jis not currently in use. 

i 

IJQ 

IJY 

1 

029[CCW ERROR 

1 

1 

{Bits 37-39 of the Channel Command Word are 
jset to nonzero. 

1 

IJQ 

IJY 

1 

030jINVALID CNOP 

1 

{Invalid range. 

1 

1 

IJQ 

IJY 

1 

031jUNKNOWN TYPE 

1 

1 

{Incorrect type designation in a EC, 

|DS, or literal. 

1 

IJQ 

IJY 

1 

032jOP-CODE NOT ALLOWED TO 
j BE GENERATED 

1 

{Operation code allowed only in source 
jstatement has been obtained through 


IJQ 033 
IJY 

IJQ 034 
IJY 


IJQ 035 
IJY 

IJQ 036 
IJY 


ALIGNMENT ERROR 


INVALID OP-CODE 


ADDRESSABILITY ERROR 


OPERAND FIELD 
MUST BE BLANK 


IJQ 037 
IJY 


MNOTE STATEMENT 


substitution of a value for a variable 
symbol. 

Referenced address is not aligned to the 
proper boundary for this instruction. 

Invalid operation code: 

1. More than eight characters. 

2. Operation entry not followed by a blank 
on same card. 

The referenced address is not within the 
range of a USING instruction. 

Operand found for an operation code which 
does not allow operands. {This message may 
be produced by the assembler if an operand is 
present in a COM, EJECT, or LTORG statement 
when the operation field has been created by 
variable symbol substitution. Operands in 
these statements are not used but are not in 
error.) 

An MNOTE statement has been generated from a 
macro definition. The text and severity code 
of the MNOTE statement is inline in the 
listing. 
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Message 

Code 


Message 


Meaning 


IJQ 0 38 
IJY 


ENTRY ERROR 


IJQ 039 
IJY 


TNUlT.Tn nBT,TMTT1?TJ 


1. More than 100 ENTRY operands in this 
program. 

2. A symbol in the ENTRY operand: 

a. Appears in more than one ENTRY 
statement. 

b. Is defined in a dummy section. 

c. Is defined in blank common. 

d. Is equated to a symbol defined by an 
EXTRN or WXTRN statement. 

e. Is equated to a value less than 
start of CSECT. 


Inv svntsY orrnr 


1 . 

2 . 

3. 

4. 

5. 


7. 

8 . 

9. 

10 . 

11 . 

12 . 


A symbol has other than alphameric 
characters. 

A symbol begins with other than alpha 
characters. 

Excessive right parenthesis. 

Equal sign encountered in a sutlist. 

Any terminating character encountered in 
an unexpected place. 

Mispunched op code causes unexpected 
syntax scan. 

A missing delimiter. 

A special character that is not a valid 
delimiter but is used as a delimiter. 

A delimiter used illegally. 

A missing operand: nothing appearing 
between delimiters. 

Unpaired parenthesis. 

An embedded blank. 


IJQ 

IJY 

040(GENERATED RECORD 

j TOO LONG 

1 

{Record has more than 187 characters. 

1 

i 

IJQ 

IJY 

I 

041jUNDECLARED VARIABLE 
j SYMBOL 

1 

| 

I 

{Variable symbol is not declared in 
ja define SET symbol statement or in a macro 
{prototype. 

i 

IJQ 

IJY 

042|SINGLE TERM LOGICAL 

JEXPRESSION IS NOT A 

|SETB SYMBOL 

1 

1 

{Single term logical expression is 

{only valid for a SETE symbol. 

1 

1 

IJQ 

IJY 

1 

0 431SET SYMBOL PREVIOUSLY 

j DEFINED 

1 

1 

{SET symbol previously defined. 

i 

i 

IJQ 

IJY 

0 4 4|SET SYMBOL USAGE 
{INCONSISTENT WITH 
j DECLARATION 

a 

J 

|A SET symbol has been declared as: 
j 1. Undimensioned but it is subscripted, 
j 2. Subscripted but it is undimensioned. 

IJQ 

IJY 

045|ILLEGAL SYMBOLIC 
|PARAMETER 
| 

1 

{Attribute requested for a variable symbol 
{which is not a symbolic parameter, 
j 

IJQ 

IJY 

I 

046jAT LEAST 1 RELOCATABLE 
jy-type CONSTANT IN 

j ASSEMBLY 

1 

jOne or more relocatable Y-type constants in 
{assembly; relocation may result in 
{address greater than 2 bytes in length. 

i 

IJQ 

IJY 

1 

047jSEQUENCE SYMBOL 
{PREVIOUSLY DEFINED 

1 

{Sequence symbol previously defined. 

1 
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Message 

Code 


Message 


Meaning 


IJQ 048 
IJY 


IJQ 049 
IJY 

IJQ 050 
IJY 


IJQ 051 
IJY 


IJQ 052 
IJY 

IJQ 053 
IJY 


IJQ 054 
IJY 


IJQ 056 
IJY 


IJQ 057 
IJY 


IJQ 059 
IJY 


SYMBOLIC PARAMETER 
PREVIOUSLY DEFINED OR 
SYMBOL DECLARED AS 
SYSTEM VARIABLE 
SYMBOLIC PARAMETER 


VARIABLE SYMBOL MATCHES 
A PARAMETER 

INCONSISTENT GLOBAL 
DECLARATIONS 


PROGRAMMER MACRO DEFINITION 
PREVIOUSLY DEFINED 


NAME FIELD CONTAINS 
ILLEGAL SET SYMBOL 

GLOBAL DICTIONARY FULL 


LOCAL DICTIONARY FULL 


ARITHMETIC OVERFLOW 


SUBSCRIPT EXCEEDS 
MAXIMUM DIMENSION 


UNDEFINED SEQUENCE 
SYMBOL 


Symbolic parameter previously defined. 
System variable symbol declared as a 
symbolic parameter. 


Variable symbol matches a parameter. 


A global SET variable that is defined in more 
than one macro definition, or in a macro 
definition and in the source program, is 
inconsistent in SET type or dimension. 

Programmer macro prototype operation entry 
is identical to a: 

1. Machine instruction. 

2. Assembler instruction. 

3. Previous programmer macro prototype. 

This message is not produced when a 
programmer macro matches a system macro. The 
programmer macro will be assembled with no 
indication of the corresponding system macro. 

SET symbol in name entry does not correspond 
to SET statement type. 

Global dictionary is full. Assembly 
is terminated. See Appendix H for dictionary 
size limits. 

Local dictionary is full. Assembly 
is terminated. See Appendix H for dictionary 
size limits. 

Intermediate or final result of an 
arithmetic operation is less than -2 31 or 
greater than 231-1. 

1. SSYSLST or symbolic parameter subscript: 

a. Exceeds 100 (200 for F assembler). 

b. Is negative. 

2. Symbolic parameter subscript is zero. 

3. SET symbol subscript exceeds dimension. 

Operand sequence symbol does not appear as a 
sequence symbol in a name field. 
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Message 

Code 


Message 


IJQ 060 
IJY 


IJQ 061 
IJY 

IJQ 062 
IJY 


IJQ 063 
IJY 

IJQ 064 
IJY 

IJQ 065 
IJY 


IJQ 066 
IJY 


IJQ 068 
IJY 

IJQ 069 
IJY 

IJQ 070 
IJY 


IJQ 071 
IJY 

IJQ 072 
IJY 


ILLEGAL ATTRIBUTE 
NOTATION 


ACTR COUNTER EXCEEDED 


GENERATED STRING GREATER 
THAN 127 [255] CHARACTERS 


EXPRESSION 1 OF SUBSTRING 
IS ZERO OR MINUS 

EXPRESSION 2 OF SUBSTRING 
IS ZERO OR MINUS 

INVALID OR ILLEGAL TERM 
IN ARITHMETIC RELATIONAL 
EXPRESSION 


UNDEFINED OR DUPLICATE 
KEYWORD OPERAND 


GENERATION TIME DICTIONARY 
AREA OVERFLOWED 

EXPRESSION 2 OF SUBSTRING 
GREATER THAN 8 CHARACTERS 

FLOATING POINT CHARACTERISTIC 
OUT OF RANGE 


ILLEGAL OCCURRENCE OF 

LCL, GBL, or ACTR STATEMENT 

ILLEGAL RANGE ON ISEQ 
STATEMENT 
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j Meaning j 

f-•( 

(L*, S', or 1* requested for a parameter | 

jwhose type attribute does not allow these j 
jattributes to be requested. j 


Conditional assembly loop counter 
exceeded—conditional assembly terminated. 

Generated string is greater than 127 
characters for D assembler or 255 characters 
for F assembler. 

Expression 1 of substring is not allowed 
to be zero or minus. 

Expression 2 of substring is not allowed 
to be zero or minus. 

1. The parameter is not a self-defining 
term. 

2. The value of the SETC symbol used in 
the arithmetic expression is not 
composed of decimal digits. 

1. A keyword operand occurs more than 
once in a macro instruction. 

2. Keyword is not defined in prototype. 

See Appendix H for dictionary size limits. 


(Expression 2 of substring is not 
jallowed to be greater than 8. 

(Exponent too large for length of 
(defining field; exponent modifier has caused 
(loss of all significant digits. 

|Local or Global declaration, or ACTR 
(Statement is out of proper sequence. 

(Operand of ISEQ statement has 
jan illegal range. 
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Message 

Code 


Message 


Meaning 


IJQ 073 
IJY 


ILLEGAL NAME FIELD 


IJQ 074 
IJY 


IJQ 075 
IJY 


IJQ 076 
IJY 

IJQ 077 
IJY 


ILLEGAL STATEMENT IN 
COPYCODE OR SYSTEM MACRO 


ILLEGAL STATEMENT 
OUTSIDE OF A MACRO 
DEFINITION 


SEQUENCE ERROR 


ILLEGAL CONTINUATION 
CARD 


IJQ 078 
IJY 

IJQ 079 
IJY 

IJQ 080 
IJY 


IJQ 081 
IJY 

IJQ 082 
IJY 


IJQ 083 
IJY 


IJQ 084 
IJY 


MACRO MNEMONIC OP-CODE 
TABLE OVERFLOW 

ILLEGAL STATEMENT IN 
MACRO DEFINITION 

ILLEGAL START CARD 


ILLEGAL FORMAT IN GBL 
OR LCL STATEMENT 

ILLEGAL DIMENSION 
SPECIFICATION IN GBL OR 
LCL STATEMENT 

SET STATEMENT NAME 
FIELD NOT VARIABLE 
SYMBOL 

ILLEGAL OPERAND FIELD 
FORMAT IN CONDITIONAL 
ASSEMBLY STATEMENT 


Name entry required to be blank is not 
blank. 

Required name entry is missing. 

Name entry required to be a sequence 
symbol is not a sequence symbol. 


1. Statement encountered in COPY code is 
not legal in COPY code. 

2. Statement encountered in system macro is 
not legal in system macro. 

Statement allowed only in a macro 
definition encountered in OPEN code, 
e.g., period asterisk (.*), mnote statement. 

Statement not in sequence specified 
by ISEQ instruction. 

1. Too many continuation cards. 

2. Nonblanks occur between the begin and 
continue columns of the continuation 
card. 

3. Card nor intended as continuation was 
treated as such because of punch in 
continue column of preceding card. 

Macro mnemonic operation code table has an 
overflow. See Appendix H. 

This operation is not allowed within a 
macro definition. 

Statement affecting, or depending upon, 
the location counter have been encountered 
before a START statement. 

An operand is not a variable symbol. 


Dimension is not within the allowed maximum 
(1-255 for Assembler D, 1-2500 for 
Assembler F) . 

The name entry of a SET statement must 
be a variable symbol. 


Syntax invalid, e.g., AIF statement 
Operand does not start with a left 
parenthesis or, sequence symbol missing in 
operand field of AIF or AGO statement. 
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Message 

Code 


Message 


Meaning 


IJQ 085 
IJY 


INVALID SYNTAX IN 
EXPRESSION 


1. Invalid delimiter. 

2. Too many terms in expression. 

3. Too many levels of parentheses, 

4. Two operators in succession. 



j 1. System vai iable symbol dput cu. ins 5 
j a. The name entry of a SET statement. j 
j b. A mixed-mode macro definition. j 
S c. A keyword macro definition, j 
j d. A GBL or LCL statement. j 
J 2. SSYSLIST in context other than N* j 
| SYSLIST. j 

|End of card encountered before an | 
jending apostrophe. j 

j 1. Symbol in operation code field does not j 
j correspond to a valid machine or | 
j assembler operation code or to any j 
| operation code in a macro prototype j 
j statement. j 
j 2. An inner macro is not defined. The j 
j opcode of the macro is not printed. j 

j The argument of the attribute reference j 
| must be a symbolic parameter and the | 
jstatement must be within a macro definition, j 

jSyntax error, e.g., no right parenthesis j 
jafter subscript; double subscript where j 
jsingle subscript is required, or single | 
| subscript where double subscript is required.j 

j 1. Value is too large. j 
j 2. Value is inconsistent with the data j 
I type, e.g., hex for decimal, etc. j 

| 1. Variable symbol is no longer j 
j than 8 characters. j 
j 2. First character after the ampersand is j 
j not alphabetic. j 
j 3. Failure to use double ampersand in TITLE] 
j card or character self-defining term. j 

jEnd of statement or card encountered j 
jbefore all parenthesis levels are j 
|satisfied. May, be caused by embedded blank j 
jor other unexpected terminator, or failure toj 
jhave a punch in continuation column. j 

j 1. Name not blank or variable symbol. | 
j 2. Variable symbol in name field is j 
j subscripted. j 
j 3. Violation of rules for forming variable j 
j symbol, (must begin with ampersand (6) j 
j followed by 1-7 letters and/or numbers j 
j first of which must be a letter) . j 
j 4. Statement following 'MACRO* is not a | 
| valid prototype statement. j 
i-.- j 
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Message 

Code 


IJY 095 


IJQ 096 
IJY 


IJQ 097 
IJY 


Message 


ENTRY TABLE OVERFLOW 


MACRO INSTRUCTION OR 
PROTOTYPE OPERAND 
EXCEEDS 127 [225] 
CHARACTERS IN LENGTH 

INVALID FORMAT IN MACRO 
INSTRUCTION OPERAND OR 
PROTOTYPE PARAMETER 


Meaning 


Number of ENTRY symbols, i.e.,ENTRY 
instruction operands, exceeds 100. 

Macro instruction or prototype 
operand length exceeds 127 
characters for D assembler and 
255 characters for F assembler. 

1. Illegal equal sign (=) . 

2. A single ampersand (£) appears 
somewhere in the standard 

value assigned to a prototype keyword 
parameter. 

3. First character of a prototype parameter 
is not an ampersand. 

4. Prototype parameter is a subscripted 
variable symbol. 

5. Invalid usage of alternate format in 
prototype (see example) . 

6. Invalid prototype parameter, e.g., SA* 
or SASS. 


Note ; Occurrence of this error will cause 
only syntax to be checked for the remainder 
of the macro definition. 


Example; 

r-1- t*-t-1 

J | ||Continuation| 

jNamejOperation!OperandjColumn | 

I-- f -f-+- i 

j |PROTO j SA,SB, | j 

II I or | | 

j jPROTO j SA,SB, j X j 

II I SC | | 

L_J_J._X_._J 


IJQ 098 
IJY 


IJQ 099 
IJY 


IJQ 100 
IJY 

IJQ 101 
IJY 


EXCESSIVE OF 
OPERANDS OR PARAMETERS 


POSITIONAL MACRO 
INSTRUCTION OPERAND 
PROTOTYPE PARAMETER 
OR EXTRA COMMA FOLLOWS 
KEYWORD 

STATEMENT COMPLEXITY 
EXCEEDED 

EOD on SYSIN or SYSIPT 


1. The prototype has more than 100 
(200 for F assembler) parameters. 

2. The macro instruction has more than 100 
(200 for F assembler) operands. 

Positional macro instruction operand 
prototype parameter or extra 
comma follows keyword. 


See Appendix H for statement complexity 
limits. 

End of data reached before an END 
statement was encountered. 
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jMeaning j 

4 - 1 

| 1. Operands of ICTL statements are | 

j out of range. j 

j 2. ICTL is not the first statement in the j 
j input deck. j 


J Syntax error^ $.g.. symbol has an j 

jillegal character or has more than j 

j 8 characters. j 

I I 

|The operand of a COPY statement | 

jspecified COPY text which cannot be j 

jfound in the library. | 

S “ I 

I I 

J 1. Mend statement missing from macro | 

j definition. j 

j 2. While editing a macro, COPY code not j 

1 found. Macro definition truncated. j 

j 3. End of file encountered while reading a j 

J macro or copy code. j 

I I 

{Referenced symbol expected to be DSECT name, j 
{but it is not. j 

I I 

{Operand unrecognizable, contains invalid | 

{value, or incorrectly specified. j 

I I 

{indicates a machine error or an internal | 

j assembler error. j 

I I 

{High order information lost by attempting j 

jto express constant in a field not long f 

jenough to contain it. j 

I I 

{Value of expression greater than j 

{-16777216 to +16777215. | 

I I 

{Expressions in EQU and ORG statements are j 

{flagged if (1) they include terms previously j 
jdefined as negative values, or (2) positive j 
{terms give a result of more than three bytes j 
jin magnitude. The error indication may be | 

jerroneous due to (1) the treatment of j 

jnegative values as three-byte positive j 

jvalues, or (2) the effect of large positive j 
jvalues on the location counter if a control J 
jsection begins with a START statement having j 
jan operand greater than zero, or a control j 

jsection is divided into subsections. j 

.x-j 
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Messages ending with an I are printed on both SYSLST and SYSLOG unless one of the 
messages indicates that SYSLST or an unidentifiable unit is defective, in which case 
they will appear on SYSLOG only. The messages appearing on SYSLOG will be prefaced by 
"A" regardless of which assembler produced them. 1101 and 1111 errors can be detected 
at any point during assembly — amount of assembly listing printed is unpredictable. 
1121 through 1151 errors are detected immediately upon assembly attempt — no assembly 
listing is printed. In either case the assembly is terminated, the source is bypassed 
to a /* or EOF, and control returned to the supervisor via EOJ. The subsequent steps 
of a multiple step JOB are not bypassed unless they are also defective. 


r-r 

Message 
Code 


Message 


Meaning 


H 


IJQ 1101 


IJQ 1111 
IJY 


IJQ 1121 
IJY 


ABORT—PERM I/O ERROR 


ABORT—UNEXPECTED EOF 
ON SYSxxx 


ABORT—INADEQUATE 
CORE FOR 32L [44K] 
ASSEMBLER 


An unrecoverable error on the designated unit 
prevents further processing. If the file 
named is SYSxxx, the unit code of the DTF 
which caused the error does not match any 
unit valid in the assembler. 

The assembler does not support multivolume 
work files. Determine the cause of EOF 
(usually short tape) and rerun with adequate 
storage for work files. 


Cause : An attempt was made to execute the 


[32K] D assembler in less than 14 k, or the F 
assembler in less than 44K. 

This is probably a user error. 

System Action : The job step is terminated. 


Programmer Action : If there is insufficient 


main storage available, you must linkage edit 
a smaller assembler. 

If the problem recurs, do the following to 
complete your problem determination action: 

1. Execute the MAP command and retain the 
output. 

2. Have the printer output available. 

Operator Action : Execute the MAP command to 
determine the partition size. Then allocate 
a larger partition for the assembly. 
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I 1 

| Message j 
(Code jMessage 


IJQ 1131jABORT--INVALID 

jPHYSICAL UNIT FOR 
j SYSxxx 




I 
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Meaning 


Cause : The assignments for a work file (s) 
are not valid. 

• The device type is not valid, or the 

is sdited foir 

different devices than those assigned. 

• The UA (unassign) or IGN (ignore) option 
was specified for the D assembler. 

• The specified mode setting is not valid. 

• For the D assembler, the work file 
device types are not consistent. 

(SYS003 is correct.) 

Only the first invalid unit is named in the 
message. 

This is probably a user error. 

System Action : The job step is terminated. 

Programmer Action : Use the LIST10 output to 
determine the cause for the message. Use 
CSERV to display the phase named "ASSEMBLY" 
and check byte X'lC', bits 5, 6, and 7 for 
the device type specified at linkage edit 
time as work files. 

Bit 5: 1=2400 

Bit 6: 1=2314 

Bit 7: 1=2311 Correct the assignments and 

resubmit the job. 

If the problem recurs, do the following to 
complete your problem determination action: 

1. Have the LISTIO and CSERV output 
available. 

2. Have the job stream and system output 
available. 

Operator Action : Issue the LISTIO command to 
check the assignments and enter the correct 
work file assignments if possible. 
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Message 

Code 


IJQ 1141 


IJY 1141 


Message 


ABORT—NO UNIT ASSIGNED FOR 
SYSPCH (for D assembler) 


ABORT—NO UNIT 
ASSIGNED FOR SYSxxx 
(OPTION SYM) 

(for F assembler) 


Meaning 


Cause : For the D assembler, the OPTION 
[DECK] is in effect and SYSPCH is not 
assigned. 

This is probably a user error. 


System Action : The job step is terminated. 

Programmer Action : Submit an assign for 
SYSPCH, 


specify OPTION [NODECK] and resubmit the job. 

If the problem recurs, do the following to 
complete your problem determination actions 

1. Retain the LISTIO listing. 

2. Have the job stream, program listing, 
and system log available. 

Operator Action ; Execute the LISTIO command 
and verify assignments. Submit an assign for 
SYSPCH and rerun the job. 

Cause s For the F assembler, a required unit 
(SYS001-SYS003 or a device required by 
an OPTION statement) is unassigned, or the 
IGN option is specified for the device. The 
(ignore) option is valid for SYSPCH and 
SYSLST. 

This is probably a user error. 

System Action ; The system terminates the job 
step. 

Programmer Action s Submit an assignment for 
the indicated logical unit. 


correct the OPTION statement to eliminate the 
requirement and resubmit the job. 

If the problem recurs, have the LISTIO 
listing, the system log, the job stream, and 
the printer output available to complete your 
problem determination action. 

Operator Action ; Execute the LISTIO command 
and verify the assignments. Submit an assign 
for the indicated logical unit and rerun the 
job. 
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Message 

Code 


Message 


j Meaning 
-+- 


IJY 1151 


ABORT—INVALID DUAL 
ASSGN SYSPCH- 
SYSIPT [SYSLST] 


IJQ 1161 


ABORT-INVALID MULTIPLE 
EXTENTS FOR WORKFILES 
(for the D assembler) 


Cause ; SYSPCH and SYSIPT are both assigned 
to the same unit, which is not a 1442N1 or 
252OBI card reader. 


[SYSPCH and SYSLST are both assigned to the 
[same unit, which is not a disk. 

This is probably a user error. 

System Action ; The job step is terminated. 

Programmer Action ; Check the LIST10 listing 
to determine the dual assignments. Reassign 
the indicated logical units to separate 
devices, or the required device type. 

If the problem recurs, retain the LISTIO 
output, the job stream, system log, and 
supervisor listing to complete your problem 
determination action. 

Operator Action ; Execute LISTIO to determine 
the current assignments. Reassign the two 
indicated logical units to separate devices 
or to the required device type. 

Cause : For the D assembler, more than one 
extent is assigned for SYS001, SYS002, 
or SYS003. 

System Action : The job step is terminated. 

Programmer Action : Probable user error. 
Correct extent job control statement. If the 
problem persists do the following before 
calling for IBM programming support. 

• Execute the LSERV program and save its 
output. 

• Have the associated jobstream and program 
listing available. 

Operator Action: None. 


Figure 35. Assembler Diagnostic Error Messages (Part 14 of 14) 


Note : If the execution of the assembler is terminated abnormally with the message 4950A 
NO MORE AVAILABLE EXTENTS, on the console , one of the assembler work files has been 
filled. This is probably caused by a conditional assembly loop resulting from a logical 
error in the source code. To locate the error, ACTR statements should be included in 
each macro definition and in the main portion of the source code. The programmer roust 
also make sure that a MACRO statement is included to identify the beginning of each 
macro definition. Otherwise the statements of the definition are included in the main 
portion of the program. 
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Appendix O. Self-Relocating Program Techniques 


Self-relocating programs are executed in a 
multiprogramming environment and at any 
location in main storage. These programs 
may be located in either foreground area of 
main storage. A program that is 
self-relocating must initialize its address 
constants, including channel command words 

(CCWs) at execution time. The user must 
code his own self-relocating routine for 
execution after it is linkage edited and 
loaded into main storage. 

When coding a self-relocating program, 
the programmer should take these points 
into consideration: 

1. All A-type address constants must be 
relocated. 

2. The I/O area addresses in all CCWs 
must be relocated. 

3. Address constants generated by 
physical IOCS macros (EXCP, WAIT, 
etc.) must be relocated. 

4. Logical IOCS macros can be 
self-relocated using the OPENR macro. 

The following example program shows how 
a user may code a self-relocating program. 
This example uses the A-type constant and 
registers 1 and 2 although the user may use 
any of the other available registers if he 
chooses. 


This program contains six address 
constants. Two are A-type and two each are 
contained in the command control block 
(CCB) and the channel command word (CCW) 
macros. This procedure is used: 


1. The absolute addresses of the contents 
of the two A-type constants (EOFTAPE 
and CHA12) and the CCW for each CCB 
(PRINTCCW and TAPECCW) are loaded into 
a work register (register 1). 

2. The work register is stored in the 
address constants [A (EOFTAPE) and 
A(CHA12)] and in their respective CCBs 
(PRINTCCB+8 and TAPECCB+8) . 

3. The command code for the CCWs shares a 
fullword with the I/O area address and 
must be reset after the I/O area 
address has been stored. This is done 
here by two methods: (a) saving the 
command code for the PRINTCCW in 
register 2 and then restoring it; (b) 
using the the Move Immediate (MVI) 
instruction for the TAPECCW to set the 
command code. 

In the main routine of this program, 
note that register notation has been used 
with the EXCP and WAIT macros to avoid the 
generation of address constants by the 
macros themselves. The example of a 
self-relocating program follows. 
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SOURCE STATEMENT 



PRINT 

NOGEN 


PROGRAM 

START 

0 



BALR 

15,0 



USING 

*,15 


* ROUTINE TO RELOCATE ADDRESS CONSTANTS 


LA 

1,PRINTCCW 

RELOCATE CCW ADDRESS 


ST 

1 ,PRINTCCB+8 

IN CCB FOR PRINTER 


LA 

1,TAPECCW 

RELOCATE CCW ADDRESS 


ST 

1,TAPECCB+8 

IN CCB FOR INPUT TAPE 


LA 

1 EOFTAPE 

♦RELOCATE***** 


ST 

1,AEOFTAPE 

* PROGRAM * 


LA 

1,CHAl2 

* ADDRESS * 


ST 

1,ACHA12 

♦♦♦♦CONSTANTS* 


IC 

2,PRINTCCW 

SAVE PRINT CCW OP CODE 


LA 

1,OUTAREA 

RELOCATE OUTPUT AREA ADDRESS 


ST 

1,PRINTCCW 

T m r»n T v?m r*r*r*-\ 

jun xrrv. xiu 


STC 

2,PRINTCCW 

RESTORE PRINT CCW OP CODE 


LA 

1,INAREA 

RELOCATE INPUT AREA ADDRESS 


ST 

1,TAPECCW 

IN TAPE CCW 


MV I 

TAPECCW, 2 

SET TAPE CCW CODE TO READ 

* MAIN ROUTINE...READ TAPE AND PRINT RECORDS 

READTAPE 

LA 

1 ,TAPECCB 

GET CCB ADDRESS 


EX CP 

(D 

READ ONE RECORD FROM TAPE 


WAIT 

(1) 

WAIT FOR COMPL. OF I/O 


L 

10,AEOFTAPE 

GET ADDRESS OF TAPE EOF ROUTINE 


BAL 

14,CHECK 

GO TO UNIT EXCEPTION SUBROUTINE 


MVC 

OUTAREA(10) ,INAREA 

EDIT RECORD 


MVC 

OUTAREA*15(70) ,INAREA*10 

IN 


MVC 

OUTAREA*90 (20) ,INAREA+80 

OUTPUT AREA 


LA 

1,PRINTCCB 

GET CCB ADDRESS 


EXCP 

(D 

PRINT EDITED RECORD 


WAIT 

(1) 

WAIT FOR COMPL. OF I/O 


L 

10,ACHA12 

GET ADDRESS OF CHAN 12 ROUTINE 


BAL 

14,CHECK 

GO TO UNIT EXCEPTION SUBROUTINE 


B 

READTAPE 


CHECK 

TM 

4 (1) ,1 

CHECK FOR UNIT EXC. IN CCB 


BCR 

1,10 

YES-GO TO PROPER ROUTINE 


BR 

14 

NO-RETURN TO MAINLINE 

CHA12 

MVI 

PRINTCCW,X'8B' 

SET SK TO CHAN 1 OP CODE 


EXCP 

(D 

SK TO CHAN 1 IMMEDIATELY 


WAIT 

(1) 

WAIT FOR COMPL. OF I/O 


MVI 

PRINTCCW,9 

SET PRINTER OP CODE TO WRITE 


BR 

14 

RETURN TO MAINLINE 

EOFTAPE EOJ 


END OF JOB 


CNOP 

0,4 

ALIGN CCB'S TO FULL WORD 

PRINTCCB 

CCB 

SYS004,PRINTCCW,X* 0400 * 


TAPECCB 

CCB 

SYS001,TAPECCW 


PRINTCCW 

CCW 

9,OUTAREA,X *20 *,110 


TAPECCW 

CCW 

2,INAREA,X'20',100 


AEOFTAPE 

DC 

A (EOFTAPE) 


ACHA12 

DC 

A (CHAl 2) 


OUTAREA 

DC 

CL110* ' 


INAREA 

DC 

CL100' ' 



END 

PROGRAM 
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Appendix P. Sample Macro Definitions 


The macro definitions in this appendix are 
typical applications of the macro language 
and conditional assembly. Another macro 
definition is included as part of Appendix 
I. The definitions are presented along 
with statements generated from typical 
corresponding macro instructions. 


The second macro definition is MOVE. 
This macro is recursive; i.e., it calls 
itself as an inner macro. Compare this 
macro definition with MOVE in Appendix I. 
MOVE in Appendix I has more statements, 
however it functions differently and 
includes error checking facilities. 


The first macro definition is NOTE — a 
DOS system macro taken from the source 
statement library of the DOS assembler. 


MACRO 

SLABEL NOTE €FILEN 

.* IBM SYSTEM/360 TAPE/DISK OPERATING SYSTEM 


CHANGE LEVEL 2-0 

A IF (T'SFILEN NE 'O'J.ONE 

MNOTE 0,* NO FILENAME SPECIFIEO.SET TO 


>**«• 


SLABEL 

L 

1»-A(*) 



*****ERROR-PATCH DTF TABLE ADDRESS 


AGO 

.THREE 




.ONE 

A IF 

(•SFILEN*(1,1) 

NE 

' ( 

•).TW0 


AIF 

(* SFILEN(1)* EQ * 

l« ) 

.FOUR 

SLABEL 

LR 

1,SFILENI1) 



GET DTF TABLE ADDRESS 


AGO 

.THREE 




.TWO 

AN0P 





SLABEL 

L 

1, = A(SFILEN) 



GET DTF TABLE ADDRESS 

.THREE 

L 

15,16(1) 



GET LOGIC MODULE ADDRESS 


AGO 

.FIVE 




.FOUR 

AN0P 





SLABEL 

L 

15,16(1) 



GET LOGIC MODULE ADDRESS 

.FIVE 

BAL 

14,12(15) 



BRANCH TO NOTE ROUTINE 


MEND 





• 

• 

• 


STATEMENTS GENERATED FROM NOTE MACRO INSTRUCTIONS 

• 


SYMBOL 

AS 

OPERAND 

NNAME 

NOTE 

INFILE 




♦# CHANGE LEVEL 

2-0 




♦NNAME 

L 

1,=A{INFILE) 

GET 

DTF TABLE ADDRESS 

♦ 

L 

15,16(1) GET 

LOGIC 

MODULE ADDRESS 

♦ 

BAL 

14,12(15) BRANCH 

TC 

1 NOTE ROUTINE 




REGISTER I AS OPERAND 


NOTE 

♦ * CHANGE LEVEL 

♦ L 

♦ BAL 


m 

2-0 

15*1611) GET LOGIC MODULE ADDRESS 
14*12115) BRANCH TO NOTE ROUTINE 


OTHER REGISTER AS OPERAND 


NOTE 

♦ * CHANGE LEVEL 

♦ LR 

♦ L 

♦ BAL 


(5) 

2-0 

1,5 GET DTF TABLE ADDRESS 
15,16(1) GET LOGIC MODULE ADDRESS 
14,12(15) BRANCH TO NOTE ROUTINE 
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OMITTED OPERAND 


NOTE 

♦* CHANGE LEVEL 2-0 


Ot NO FILENAME SPECIFI ED.SET TO •** 

♦ L 1 * =A(*) *****ERROR-PATCH DTF TABLE ADDRESS 

♦ L 15*16(1) GET LOGIC MODULE ADDRESS 

♦ BAL 14*12(15) BRANCH TO NOTE ROUTINE 


MACRO 


CNAME 

MOVE 

&FROM,CTO,&COUNT 



• * 

.* 

A 


RECURSIVE GENERAL 

PURPOSE MOVE MACRO 


• • 

GBLA 

f* 




LCLA 

CB 



CB 

SETA 

CCOUNT 



.PN 

AIF 

(CB LE 256).DO 

MOVE LESS THAN 256 

BYTES 

CNAME 

MVC 

CT04-CA. ( 256),CFROM+CA 

256 BYTE MOVE 


CA 

SETA 

CA+256 



CB 

SETA 

CB-256 




MOVE 

MEXIT 

CFROM,CTO,CB 

CALL THYSELF 


• DO 

ANOP 




CNAME 

MVC 

CTO+CA.(CB),CFROM+CA 

LESS THAN 256 BYTE 

MOVE 

CA 

SETA 

MEND 

0 

SET BACK TO 0 FOR 

NEXT CALL 


• STATEMENTS GENERATED FROM MOVE MACRO INSTRUCTIONS 


* MOVE LESS THAN 256 BYTES 

MNAME MOVE FRMAD,TOAD*150 

♦MNAME MVC TOAO+O(150),FRMAD+O LESS THAN 256 BYTE MOVE 




MOVE 256 BYTES 


♦ 


MOVE FRMAD*TOAD,256 

MVC TOAD*0(256) ,FRMAD«-0 LESS THAN 256 BYTE MOVE 




MOVE MORE THAN 256 BYTES 


MNAME2 

+MNAME2 


MOVE FRMAD,TOAD,400 

MVC T0AD*0(256),FRMAD*0 256 BYTE MOVE 

MVC TOAO+256(144),FRMAD+256 LESS THAN 256 BYTE MOVE 


MOVE MORE THAN 


512 BYTES 


♦ 

♦ 


MOVE FRMAD,TOAD,520 

MVC T0AD*0(256),FRMAD«-0 256 BYTE MOVE 

MVC T0AD+256(256),FRMAD*256 256 BYTE MOVE 

MVC TOAD*512(8),FRMAD*512 LESS THAN 256 BYTE MOVE 
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Index 


Indexes to systems reference library manuals are consolidated in IBM System/360 Disk 
Operating System Master Index , GC24-5063 and in IBM System/360 Tape Operating System 
Programming Index , GC24-5064. For additional information about any subject listed 
below, refer to other publications listed for the same subject in the consolidated 
index. 


&SYS, restrictions on use 76,88,101 ANOP instruction 97 

&SYSECT (see Current control section name) Example of 97 

&SYSLIST (see macro instruction operand) Form of 97 

&SYSNDX (see macro instruction index) Sequence symbol in 97 

&SYSPARM (see system parameter for Use of 97 

conditional assembly) Apostrophes in 

7090/7094 Support Package Assembler 13,170 Character expressions 91 


Absolute terms 20 
ACTR instruction 97 
Address constants 56 
A-type 57 

Complex relocatable expressions 57 

Literals not allowed 25 

S-type 57 

V-type 5 8 

Y-type 57 

Address specification 42 
Addressing 31 

Dummy sections 36 
Explicit 31 

External control sections 39 
Implied 31 
Relative 34 
AGO instruction 96 
Example 96 
Form of 96 

Inside, macro definitions 96 
Operand field of 96 
Outside macro definitions 96 
Sequence symbol in 96 
Use of 96 
AIF instruction 95 
Example of 95 
Form of 95 

Inside macro definitions 95 
Invalid operand fields of 95 
Logiqal expression in 95 
Operand field of 95 
Outside macro definitions 95 
Sequence symbols in 95 
Use of 95 

Valid operand fields of 96 
Alignment, boundary 

CNOP instruction for 65 
Machine instruction 41 
Ampersands in 

Character expressions 92 
Macro-instruction operands 79 
MNOTE instruction 99 
Symbolic parameters 74 
Variable symbols 72 


Macro instruction operands 77 
MNOTE instruction 99 
Arithmetic expressions 

Arithmetic relations 94 
Evaluation procedure 89 
Invalid examples of 89 
Operand sublists 90 
Operators allowed 88 
Parenthesized terms in 89 
evaluation of 89 
examples of 89 
SETA instruction 88 
SETB instruction 93 
Substring notation 91,92 
Terms allowed 88 
Valid examples of 88 
Arithmetic relations 94 
Arithmetic variable 104 
Assembler instructions 
Statement 46 
Table 144 

(see specific instructions) 
Assembler language 13 

Basic Operating System 13 
Basic Programming Support 13,170 
Coding conventions 16 
Comparison chart 170 
Macro facilities, relation to 71 
Statement format 17 
Structure 19,20 
Assembler program 

Basic functions 12 
DOS/TOS relationship 15 
Listing 160 
Output 34,183 
Variants 182 

Assembler relationships 15 
Assembling a Program 174 

Assemble-and-execute 13,178,181 
Card Input 174,178,181 
Device Assignments 176,177 
Diagnostic Error Messages 187 
I/O Units Used 179,180 
Operating Considerations 176,177 
Output 183 
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Assembly, terminating an 67 
Assembly no operation (see ANOP 
instruction) 

Attributes 84 

How referred to 85 

Inner macro instruction operands 84 
Kinds of 84 
Notations 84 
Operand sublists 84 

Outer macro instruction operands 84 
Summary chart of 151 
Use of 84 

(see also specific attributes) 


Basic Programming Support Assembler 13, 170 
Base Registers 

Address calculation 15,39,42 
DROP instructions 32 
Loading of 31 
USING instructions 31 
Binary constant 53 
Binary self-defining term 24 
Binary variable 104 
Bit length specification 49 
Mutiple constants 50 
Multiple operands 50 
Duplicated constants 50 
Blanks 

Logical expressions 93 
Macro instruction operands 79 


CCW instruction 60 
Channel command word, defining 60 
Character codes 113 
Character constant 51 
Character expressions 91 
Ampersands in 91 
Character relations 94 
Concatenating 92 
Examples of 91 
Periods and 91 
Apostrophes in 91 
SETB instructions 93 
SETC instructions 90 
Character relations 94 
Character self-defining term 24 
Charcter set 19,20,112 
Character variable 104 
CNOP instruction 65 
Coding form 17 
COM instruction 36 

Commas, macro instruction operands 79 
Comments entries 18 
Comments statements 
Examples of 19,78 
Model statements 78 
Not generated 78 
Comparison chart 70 
Compatibility between System/360 
assemblers 12 

DOS/TOS assembler variants 12 
DOS/TOS assemblers and OS assemblers 13 
DOS/TOS assemblers and BOS/BPS 
assemblers 13 
Macro-definitions 111 


Complex relocatable expressions 57 
Concatenation 

Character expressions 91,92 
Defined 77 
Examples of 77 
Substring notations 91 
Conditional assembly elements, summary 
charts of 97,150 
Conditional assembly instructions 
How to write 83 
Summary of 98 
Use of 83 

(see also specific instructions) 
Conditional branch (see AIF instruction) 
Constants (see also specific types) 
Defining (see DC instructions) 

Summary of 147 
Continuation lines 16 
Conditional branch instruction 44 
Operand format 43,44 
Control section location assignment 35 
Control sections 
Blank common 36 
CSECT instruction 35,36 
Defined 34 
DSECT instruction 36 

First control section, properties of 35 
START instruction 35 
Unnamed 36 
COPY instruction 66 

COPY statements in macro definitions 
Form of 78 

Model statements, contrasted 78 
Operand field of 78 
Use of 78 
Count attribute 


Defined 

86 


Notation 

84 


Operand 

sublists 

86 

Use of 

86 


Variable 

symbols 

86 


CSECT instruction, symbol in, length 
attribute of 35, 36 
Current control section name (&SYSECT) 
Affected by CSECT, DSECT, START 105 
Example of 106 
Use of 105 


Data definition instructions 47 
Channel command words 60 
Constants 47 
Storages 58 

Data representation 15 
DC instruction 47 

Duplication factor operand subfield 48 
Operand subfield modifiers 48 
Type operand subfield 48 
Length modifier 48 
Scale modifier 50 
Exponent modifier 51 
Constant operand subfield 51 
Address-constants (see address 
constants) 

Binary constant 53 
Character constant 52 
Decimal-constants 56 
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DC instruction (continued) 

Fixed-point constants 53 
Floating-point constants 54 
Hexadecimal constant 52 
Type codes for 50 
Decimal constants 56 
Length modifier 56 
Length, maximum 56 
Packed 54 
Zoned 54 

Decimal field, integer attribute of 87 
Decimal self-defining terms 91 
Defining constants (see DC instruction) 
Defining storage (see DC instruction; 

DS instruction) 

Defining symbols 22,83 
Diagnostic Error Messages 187 
Dimension, subscripted SET symbols 104 
Displacements 42 
Double-shift instruction 42 
DROP instruction 32,42 
DS instruction 58 
Defining areas 59 
Forcing alignment 59 
DSECT instruction 36 

Dummy section location assignment 36,38 
Duplication factor 48 
Forcing alignment 59 


Effective address length 43 
EJECT instruction 61 
END instruction 67 
ENTRY instruction 38,39 

Entry point symbol, identification of 38 
EQU instruction 46 
Equal signs, as macro instruction 
operands 79 

Error message (see MNOTE instruction) 

Error Messages 187 

After END statement 67 
Explicit addressing 31,42 
Length 42 

Exponent modifiers 51 
Expressions 26,27,38 
Absolute 42 
Character 91 
Evaluation 27 
Logical 94 
Relocatable 42 
Summary chart of 150 
Extended mnemonic codes 44 
Operand format 45 
Table 123 

External control section, addressing of 39 
External symbol, identification of 39 
EXTRN instruction 39 


First control section 35 
Fixed-point constants 53 
Format 53 
Positioning of 53 
Scaling 54 

Values, minimum and maximum 53,54 
Fixed-point field, integer attribute 
of 86 


Floating-point constants 54 
Alignment 55 
Format 55 
Scale modifiers 55 

Floating-point field, integer attribute 
of 87 

Format Control, input 63 


GBLA instruction 
Form of 101 

Inside macro definitions 101 
Outside macro definitions 101 
Use of 101 
GBLB instruction 
Form of 101 

Inside macro definitions 101 
Outside macro definitions 101 
Use of 101 
GBLC instruction 
Form of 101 

Inside macro definitions 101 
Outside macro definitions 101 
Use of 101 

General register zero, base register 
usage 32 

Generated statements, examples of 77 
Global SET symbols 
Defining 101 
Examples of 101,102,103 
Local SET symbols, compared 100 
Using 101 

Global variable symbols 
Types of 100 

(see also global SET symbols, sub¬ 
scripted SET symbols) 


Hexadecimal constants 52 

Hexadecimal-decimal conversion chart 116 
Hexadecimal self-defining terms 23 


I 1 (see Integer attribute) 

ICTL instruction 63 
Identification-sequence field 19 
Identifying blank common control 
section 37,38 

Identifying assembly output 60,61 
Identify dummy section 36 
Implied addressing 31,42 
Length 42 

Implied length specification 42 
Inner macro instruction 
Defined 79 
Example of 82 
Symbolic parameters in 82 
Instruction alignment 41 
Instruction format 19 
Interger attributed 
Decimal fields 87 
Examples of 87 
Fixed-point fields 87 
Floating-point fields 87 
How to compute 87 
Notation 84 
Restrictions on use 87 
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Integer attributed (continued) 
Use of 87 
ISEQ instruction 63 


K' (see Count attribute) 

Keyword 

Defined 108 

Keyword macro instruction 108 
Symbolic parameter and 107 
Keyword, inner macro instructions used 
in 109 

Keyword macro definition 

Positional macro definitions 107 
compared 107 
Use 107 

Keyword macro instruction 
Example of 109 
Format of 108 
Keywords in 108 
Operands 68,108 
Invalid examples 109 
Valid examples 109 
Operand sublists in 109 
Keyword prototype statement 
Examples of 108,109 
Format of 108 
Operands 108,109 

Invalid examples 108 
Valid examples 10P 
Standard values 108 


L' (see Length attribute) 

LCLA instruction 
Form of 88 
Use of 88 
LCLB instruction 
Form of 88 
Use of 88 
LCLC instruction 
Form of 88 
Use of 88 
Length modifier 48 

Bit length specification 49 
Lengths explicit and implied 42,43 
Length attribute 
Defined 43,85 
Examples 85 
Notation 84 
Restrictions on use 86 
Symbols 22,86 
Use of 85, 86 
Length modifier 48 
Length subfield 41 
Level of parentheses 26 
Library, copying coding form 66 
Linkage symbols (see also ENTRY 
instruction; EXTRN instruction) 
Entry point symbol 38 
External symbol 38 
Linkage editor and use of 38 
Listing, spacing 61,62 
Listing control instructions 60 
Literal pools 26,64,65 

Segments one to four 65 


Literals 25 


Character 42 


DC instruction, used in 

25 

Duplicate 26 


Format 25 


Literal pool, beginning 

65 

Literal pools, multiple 

26 

Treatment of self-defining term 


Local SET symbols 
Defining 101 


Examples of 101,102,103 
Global SET symbols, compared 100 
Using 101 

Local variable symbols 
Types of 100 

(see also local SET symbols) 

(see also subscripted SET symbols) 
Location counter 46,51,57 
Predefined symbols 23 
References to 23 
Setting 64 
Logical expressions 

AIF instructions 95 
Arithmetic relations 94 
Blanks in 94 
Character relations 94 
Evaluation of 94 
Invalid examples of 94 
Logical operators in 94 
Parenthesized terms in 
Evaluation of 94 
Examples of 94 
Relation operators in 94 
SETB instructions 93 
Terms allowed in 94 
Valid examples of 94 
LTORG instruction 64,65 


Machine features required 9 
Machine instructions 41 

Alignment and checking 41 
Length 43 

Literals, limits on 25 
Mnemonic operation codes 43 
Operand fields and subfields 41 
Symbolic operand formats 43 
Machine-instruction mnemonic codes 43 
Alphabetical listing 123 
MACRO 

Form of 74 
Use 74 

Macro definition 

Compatibility 111 
Defined 74 
Example of 76 
How to prepare 74 

Keyword (see Keyword macro definition) 
Mixed-mode (see Mixed-mode macro 
definition) 

Placement in source program 74 
Sample 162,203,204 
Use 74 

Macro definition exit (see MEXIT 
instruction) 

Machine instruction examples and format 
RR 41,43,44 
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Machine instruction examples and format 
(contined) 

RX 41,44 
RS 41,44 
SI 41,44 
SS 41 44 

Summary table 120,121 
Macro definition header statement (see 
MACRO) 

Macro definition trailer statement (see 
MEND) 

Macro facility 

Additional features 97,98 
Comparison chart 173 
Relation to assembler language 71 
Summary 98,149 
Macro instruction 
Defined 71 
Example of 80 
Form of 13 
How to write 79 
Levels of 82 
Inner 82 

Mnemonic operation code 79 
Name entry of 79 
Omitted operands 80 
Example of 80 
Operand entry of 79 
Operands 

Ampersands 80 
Blanks 80 
Commas 80 
Equal signs 80 
Paired parentheses 79 
Paired apostrophes 79 
Operand sublists 80,81 
Operation entry of 79 
Outer 81 
Statement form 80 
Types of 69 

Used as model statement’ 81 
Macro instruction index (&SYSNDX) 

AIF instruction 104 
Arithmetic expressions 104 
Character relation 104 
Example 105 
MNOTE instruction 104 
SETB instruction 104 
SETC instruction 105 
Use of 104 

Macro instruction operand (&SYSLIST) 
Attributes of 106 
Use of 106,109 
(see also symbolic parameters) 

Macro instruction prototype statement 
(see prototype statement) 

Macro instruction statement (see macro 
instruction) 

MEND 

Form of 74 

MEXIT instruction, contrasted 99 
Use of 74 
MEXIT instruction 
Example of 99 
Form of 99 
MEND, contrasted 99 
Use of 99 


Mixed-mode macro definitions 

Positional macro definitions 
contrasted 110 
Use 109,110 

Mixed-mode macro instruction 
Example of 110 
Form of 110 

Operand field of 69,110 
Mixed-mode prototype statement 
Example of 110 
Form of 110 
Operands of 110 
Mnemonic operation codes 43 
Extended 44 
Machine instruction 43 
Macro instruction 74 
MNOTE instruction 

Ampersands in 100 
Error message 100 
Example of 100 
Operand entry of 99,100 
Apostrophes in 100 
Severity code 100 
Use of 99 
Model statements 

Comments field of 76 
Comments statements 78 
Defined 75 
Name field of 75 
Operation field of 75 
Operand field o'f 76 
Use of 75 


N' (see Number attribute) 
Name entries 18 
Number attribute 
Defined 86 
Notation 86 
Operand sublist 86 


Object deck 183 
Object module 34 
Operands 

Entries 17,18 
Fields 41 
Subfields 41,42 
Symbolic 38,41,43 
Operand sublist 

Alternate statement form 81 
Defined 80 
Example of 81 
Use of 81 
Operation codes 
Assembler 14 
Machine 14 

Operation entries 17,18 

Operation field 41 

Ordinary symbol 22 

ORG instruction 64 

Outer macro instruction defined 81 


Paired parentheses 79 
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Paired apostrophes 79 
Parentheses in 

Arithmetic expressions 89 
Logical expressions 94 
Macro instruction operands 79,80 
Operand fields and subfields 42 
Paired 79 
Period in 

Character expressions 91 
Comments statements 78 
Concatenation 78 
Sequence symbols 87 
Positional macro definition (see macro 
definition) 

Positional macro instruction (see macro 
instruction) 69 
Previously defined symbols 23 
PRINT instruction 62 
Program control instructions 62 
Program listings 15 

Program sectioning and linking 21,31,34 
Prototype statement 
Alternate 75 
Example of 75 
Form of 74 

Keyword (see keyword prototype state¬ 
ment) 

Mixed-mode (see mixed-mode prototype 
statement) 

Name entry of 74 
Operand entry of 74 
Operation entry of 74 
Statement form 74,75 
Symbolic parameters in 74 
Use of 74 

PUNCH instruction 63,64 


Relational operators 94 
Relative addressing 34 
Relocatability 15,20 
Attributes 38 

PrCvgram, general register zero 32 
Relocatable expressions 28,41 
In USING instructions 32 
Relocatable symbols 22 
Relocatable terms 
Pairing of 27 

In relocatable expressions 28 
REP card 186 
REPRO instruction 64 
RR machine instruction format 41,42 
Length attribute 41 
Symbolic operands 43 
RS machine instruction format 41,42 
Address specification 42 
Length attribute 41 
Symbolic operands 43 
RX machine instruction format 41,42 
Address specification 42 
Length attribute 41 
Symbolic operands 43 


S' (see scaling attribute) 

Sample macro definitions 161,203,204 
Sample program 160 


Scale modifier 

Fixed-point constants 50 
Floating-point constants 50,51 
Scaling attribute 

Decimal fields 85,86 
Defined 85 

Fixed-point fields 85,86 
Floating-point fields 85,86 
Notation 102 
Restrictions on use 86 
Ct rrin V vQS S f S S 

Use of 85,86 

Self-defining terms 23,24 
Binary 24 
Character 24 
Decimal 23 
Hexadecimal 23 
Using 23 

(see also specific terms) 

Sequence checking 63 
Sequence symbols 22,86,87 
AGO instruction 96 
AIF instruction 95,96 
ANOP instruction 97 
How to write 86,87 
Invalid examples of 87 
Macro instruction 87,88 
Use of 87 

Valid examples of 87,88 
Set symbols 

Assigning values to 83 
Defining 83 

Symbolic parameters, contrasted 83 
Use 83 

(see also local SET symbols) 

(see also global SET symbols) 

(see also subscripted SET symbols) 
SET variable 100,101 
SETA instruction 

Examples of 89,90 
Form of 88 
Operand entry of 88 

Evaluation procedure 89 
Operators allowed 88 
Parenthesized terms 89 
Terms allowed 88 
Valid examples of 88 
Operand sublist 90 
Example 90 
SETB instruction 
Example of 95 
Form of 93 

Logical expression in 94 
Arithmetic relations 94 
Blanks in 94 
Character relations 94 
Evaluation of 94 
Operators allowed 94 
Operand entry of 93,94 
Invalid examples of 94 
Valid examples of 94 
SETC instruction 
Apostrophes 90 
Character expressions in 90 
Ampersands 90 
Periods 90 
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SETC instruction (continued) 
Concatenation in 

Character expressions 91 
Substring notations 91,92 
Examples of 90,91,92 
Form of 90 
Operand entry of 90 
Substring notations in 91,92 
Arithmetic expressions in 92 
Character expressions in 92 
Invalid examples of 92 
Valid examples of 92 
Type attribute in 90,91 
Example of 91 
SETA symbol 

Assigning values to 83 
Defining 83 
SETA instruction 89 
Using 89 
SETB symbol 

AIF instruction 95,96 
Assigning values to 83 
Defining 83 
SETA instruction 95 
SETB instruction 95 
SETC instruction 95 
Using 95 
SETC symbol 

Assigning values to 83 
Defining 83 
SETA instruction 94 
Using 93 
Severity code 177 

Severity code in MNOTE instruction 100 
SI machine instruction format 44 
Address specification 42 
Length attribute 41 
Symbolic operands 43 
Source module 34 ^ 

Source statement library defined 72 
SPACE instruction 61,62 
SS machine instruction format 41,44 
Address specification 42 
Length attribute 41 
Length field 42 
Symbolic operands 43 
START instruction 

Positioning of 34 
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Index 211 



Unamed control section 35 
USING instruction 31,42 


Variable symbols 22 

Assigning values to 72 
Defined 72 
How to write 72 
Restrictions in use to generate 
operation codes 74,75 
Summary chart of 150 
System 104,105 


Variable symbols (continued) 

Types of 72 
Use 72 

(see also specific variable symbols) 
V-type address constant 58 


XFR instruction 13 


Y-type address constant 57 


212 




GC24-3414-9 



International Business Machines Corporation 
Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 
(U.S.A. only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(International) 


DOS and TOS Assembler Language Printed in U.S.A. GC24-3414-9 



CUT ALONG DOTT|P LINE 


DOS and TOS Assembler 
Language 

GC24-3414-9 


READER'S 

COMMENT 

FORM 


Your views about this publication may help improve its usefulness; this form 
will be sent to the author’s department for appropriate action. Using this 
form to request system assistance or additional publications will delay response, 
however. For more direct handling of such request, please contact your 
IBM representative or the IBM Branch Office serving your locality. 


Reply reque sted: 
Yes I 1 
No □ 


Name: _ 

Job Title:_ 

Address: ____ 

_ Zip 


Thank you for your cooperation. No postage stamp necessary if mailed in the U.S.A. (Elsewhere, an IBM office 
or representative will be happy to forward your comments.) 





GC24-3414-9 


Your comments, please ... 

This manual is part of a library that serves as a reference source for systems analysts, 
programmers, and operators of IBM systems. Your comments on the other side of this 
form will be carefully reviewed by the persons responsible for writing and publishing 
this material. All comments and suggestions become the property of IBM. 


Fold 


Fold 


t 


Business Reply Mail 

No postage stamp necessary if mailed in the U.S.A. 


Postage will be paid by: 

International Business Machines Corporation 
Department 813 L 
1133 Westchester Avenue 
White Plains, New York 10604 


First Class 
Permit 40 
Armonk 
New York 



( 

< 


i 

I 

d 


Fold 


Fold 


I 


; 

< 

i 



International Business Machines Corporation 
Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 
(U.S.A. only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(International) 


( 

< 

I 


Us 


CUT OR FOLD ALONG LINE 








